그누보드 5.6.48 업데이트, 모바일 결제 오류 해결…운영자 필수 확인

그누보드 5.6.48 업데이트, 무엇이 달라졌나요?

그누보드 5.6.48이 2026년 11월 9일 공식 배포됐습니다. 이번 업데이트는 NHN KCP REST API를 이용하는 쇼핑몰의 모바일 결제창 오류와 이전 로그인 정보로 발생하는 PHP 경고를 해결하는 데 초점을 맞췄습니다. 그누보드 개발사 SIR이 공개한 릴리즈 노트에 따르면 PC에서는 정상적으로 결제되지만 모바일에서는 실제 결제창이 열리지 않는 문제를 수정했습니다. 기존 회원 정보가 없는 상태에서 로그인 세션이 유지될 때 발생할 수 있는 오류도 함께 개선했습니다.

이번 배포판은 5.6.47을 패치 기준으로 하며, 별도의 신규 DB 업그레이드나 삭제 대상 파일이 없습니다. 다만 이전 버전에서 완료하지 못한 DB 변경 작업은 확인해야 합니다.

NHN KCP 모바일 결제 오류, 원인과 해결 내용

이번 버전에서 가장 주목할 변화는 NHN KCP REST API의 모바일 실결제창 연결 문제를 해결했다는 것입니다.

영카트 쇼핑몰에서 PC 결제는 정상적으로 진행되지만 모바일 결제창이 열리지 않는 상황이 발생할 수 있었습니다.

문제는 KCP의 거래등록 자체가 반드시 실패한 것이 아니라, 거래등록 이후 KCP가 전달한 결제창 주소를 쇼핑몰 프로그램이 허용하지 않는 데 있었습니다.

결제 서비스가 정상적인 주소를 전달했더라도 프로그램의 주소 검증 조건에 맞지 않으면 결제창으로 이동하지 못하는 구조였습니다.

이번 패치는 정상적인 운영 결제창 주소를 허용하도록 수정해 모바일 결제 과정을 이어갈 수 있도록 했습니다.

새롭게 허용된 결제창 주소

기존에 허용하던 KCP 결제창 주소 외에 실제 운영 환경에서 사용하는 주소가 추가됐습니다.

• 기존 주소: smpay.kcp.co.kr
• 추가 허용 주소: rsmpay.kcp.co.kr
• 적용 대상: KCP REST API 모바일 거래등록 응답
• 변경 목적: 정상적인 운영 결제창으로 이동할 수 있도록 주소 검증 조건 보완

여기서 중요한 부분은 결제창 주소를 무조건 허용하도록 변경한 것이 아니라는 점입니다.

기존의 테스트·운영 환경 구분, HTTPS 검증, 위장 도메인 거부 조건은 그대로 유지됩니다.

따라서 이번 수정은 주소 검증 기능을 해제한 것이 아니라 정상적인 KCP 운영 주소를 검증 대상에 추가한 조치입니다.

모바일 결제가 안 된다면 무엇을 확인해야 하나요?

KCP REST API를 사용하는 영카트 운영자라면 업데이트 이후 실제 모바일 결제 흐름을 점검하는 것이 좋습니다.

• PC에서 기존 결제 기능이 정상적으로 작동하는지 확인합니다.
• 모바일에서 실제 결제창이 정상적으로 열리는지 점검합니다.
• KCP 거래등록 이후 결제창으로 이동하는 과정에 오류가 없는지 확인합니다.
• 자체 수정한 결제 관련 코드가 있다면 변경 사항을 비교합니다.
• 결제 완료 후 주문정보와 승인정보가 정상적으로 처리되는지 확인합니다.

공식 수정 내용은 KCP REST 모바일 결제창 주소 검증에 관한 것입니다. 따라서 모든 모바일 결제 오류를 이번 패치 하나로 해결할 수 있다고 해석해서는 안 됩니다.

실제 오류가 발생한다면 이용 중인 결제 방식과 오류 발생 단계도 함께 확인해야 합니다.

로그인 세션 오류와 PHP 경고도 개선

그누보드 5.6.48에는 결제 기능 외에 회원 로그인 상태를 처리하는 개선 사항도 포함됐습니다.

같은 도메인에 사이트를 새로 설치하거나 기존 회원을 삭제한 경우, 브라우저에는 이전 로그인 정보가 남아 있을 수 있습니다.

이때 서버의 새로운 데이터베이스에는 해당 회원 정보가 없는데도 로그인 세션이 유지되면 문제가 발생할 수 있습니다.

기존 프로그램이 회원 조회 결과를 확인하기 전에 회원정보를 읽으려고 하면 PHP 경고가 표시될 수 있기 때문입니다.

상황에 따라 첫 화면 접근이나 로그인 처리, 페이지 이동이 방해받을 수 있었습니다.

회원정보가 없으면 로그인 상태 자동 해제

이번 업데이트에서는 회원 조회 결과가 존재하지 않을 때 로그인 세션과 인증 토큰을 먼저 해제하도록 수정했습니다.

이후 사용자를 비회원 상태로 전환해 다시 로그인할 수 있도록 처리합니다.

예를 들어 동일한 주소에 그누보드를 다시 설치했지만 방문자의 브라우저에는 이전 사이트의 로그인 정보가 남아 있는 상황을 생각해 볼 수 있습니다.

새로운 데이터베이스에서 해당 회원을 찾을 수 없다면 기존 로그인 상태를 정리하고 비회원으로 처리하게 됩니다.

회원이 삭제됐지만 과거 로그인 정보가 남아 있는 경우에도 같은 개선 사항이 적용됩니다.

이번 조치는 회원정보 불일치로 발생하는 PHP 경고를 줄이고, 로그인 절차를 정상적으로 이어갈 수 있도록 하는 데 의미가 있습니다.

다만 모든 PHP 경고나 로그인 관련 오류를 해결하는 수정은 아닙니다. 회원 조회 결과가 없는 상황에 대한 처리 개선으로 이해하는 것이 정확합니다.

그누보드 5.6.48 수정 파일과 DB 업그레이드 여부

이번 배포판은 수정 범위가 비교적 명확합니다. 공식 릴리즈 노트에 따르면 이번 문제와 관련된 제품 수정 파일은 두 개입니다.

common.php는 그누보드의 공통 실행 및 회원 상태 처리와 관련된 파일입니다. 이번에는 존재하지 않는 회원의 로그인 세션을 정리하는 기능이 개선됐습니다.

lib/kcp_rest.lib.php는 KCP REST API 결제 연동에 사용하는 라이브러리입니다. 이번 버전에서는 정상적인 모바일 운영 결제창 주소를 추가로 허용합니다.

두 파일은 그누보드와 영카트의 실제 운영에 영향을 줄 수 있는 부분이므로 기존에 사용자 정의 기능을 추가했다면 단순 덮어쓰기보다 변경 내용을 확인하고 병합하는 것이 안전합니다.

DB 업그레이드가 없으면 관리자 확인도 필요 없나요?

그렇지는 않습니다.

5.6.48 자체에는 별도로 추가된 DB 업그레이드 항목이 없지만, 이전 버전에서 완료하지 않은 변경 작업이 있다면 확인해야 합니다.

특히 5.6.47에서 적용된 거래번호 비교 방식 변경과 관련된 마이그레이션을 아직 완료하지 않았다면 해당 작업을 마쳐야 합니다.

따라서 신규 DB 변경이 없다는 안내를 이전 버전의 미완료 업그레이드까지 생략해도 된다는 의미로 받아들이지 않는 것이 좋습니다.

5.6.47에서 5.6.48로 업데이트하는 방법

현재 운영 중인 그누보드 버전에 따라 적용 방법을 구분해야 합니다.

5.6.47을 사용 중이라면 공식 패치 ZIP을 기준으로 업데이트할 수 있습니다. 그보다 오래된 버전이라면 전체 배포본을 기준으로 기존 수정 사항과 필요한 변경 내용을 병합해야 합니다.

업데이트 전 확인할 사항

• 1단계 백업: 운영 중인 사이트 파일과 MySQL 데이터베이스를 백업합니다.
• 2단계 서비스 중지: 파일 변경 중 이용자 요청이나 결제 처리가 발생하지 않도록 사이트 이용을 일시 중지합니다.
• 3단계 버전 확인: 현재 버전이 5.6.47인지, 그보다 이전 버전인지 확인합니다.
• 4단계 수정 사항 확인: 공통 파일이나 결제 라이브러리에 직접 추가한 사용자 정의 코드가 있는지 점검합니다.
• 5단계 기존 설정 보존: 운영 중인 data 디렉터리와 DB 연결 설정 등 기존 환경에 필요한 내용을 보존합니다.

패치 파일 적용 시 주의사항

이번 수정 때문에 PHP 버전이나 웹서버 설정을 별도로 변경할 필요는 없습니다.

기존 세션 파일을 일괄 삭제하거나 KCP 인증서 및 인증키를 교체할 필요도 없습니다.

다만 PHP OPcache 등 코드 캐시를 사용하는 환경에서는 수정 파일을 적용한 뒤 실제로 새로운 코드가 로드됐는지 확인해야 합니다.

코드가 갱신됐더라도 캐시에 남은 이전 코드가 실행되면 수정 효과를 바로 확인하기 어려울 수 있습니다.

운영자가 직접 변경한 파일이 있다면 공식 배포본과 비교해 수정 내용을 반영하는 것이 좋습니다.

공식 GitHub에서 5.6.47과 5.6.48의 변경 사항을 확인할 수 있습니다.

업데이트 완료 후 반드시 점검할 기능

파일 적용이 끝났다면 곧바로 정상 운영을 재개하기보다 주요 기능을 확인해야 합니다.

이번 패치의 핵심은 결제와 로그인 상태 처리이므로 두 기능을 중심으로 점검하는 것이 효율적입니다.

• 메인 화면: 첫 접속 시 PHP 경고나 화면 출력 오류가 발생하지 않는지 확인합니다.
• 회원 로그인: 정상 회원의 로그인과 로그아웃 기능을 확인합니다.
• 과거 세션: 회원정보가 존재하지 않는 이전 로그인 상태에서 비회원으로 정상 전환되는지 점검합니다.
• 모바일 결제: KCP REST API를 사용하는 경우 모바일 결제창이 정상적으로 열리는지 확인합니다.
• 결제 처리: 테스트 가능한 환경에서 주문과 결제 승인 결과가 정상적으로 연결되는지 확인합니다.
• 기존 기능: 사용자 정의 코드와 쇼핑몰 운영 기능에 예상하지 못한 문제가 발생하지 않는지 확인합니다.

특히 실결제 환경을 사용하는 쇼핑몰에서는 테스트 과정에서 실제 결제가 발생하지 않도록 주의해야 합니다.

기능 확인이 끝났다면 이용자에게 서비스를 다시 제공하면 됩니다.

그누보드 5.6.48 배포 파일과 다운로드 정보

SIR에서 제공하는 공식 배포 파일은 전체 설치 파일과 패치 파일로 구분됩니다.

파일 용량은 2026년 11월 9일 공식 배포 게시글에 표시된 기준입니다.

업데이트 파일은 공식 SIR 배포 페이지에서 내려받는 것이 좋습니다.

자주 묻는 질문

• 그누보드 5.6.48에서 DB 업그레이드가 필요한가요?
  5.6.48에 새롭게 추가된 DB 업그레이드 항목은 없습니다. 다만 이전 버전에서 완료하지 않은 관리자 DB 업그레이드 항목은 확인해야 하며, 특히 5.6.47의 거래번호 비교 방식 변경 관련 마이그레이션이 완료됐는지 점검해야 합니다.
• KCP REST API를 사용하지 않는 사이트도 업데이트해야 하나요?
  이번 버전에는 KCP 결제 기능 외에 로그인 세션 처리 개선도 포함돼 있습니다. 따라서 KCP REST API를 사용하지 않는 일반 게시판 사이트에서도 해당 수정 사항이 의미가 있을 수 있습니다.
• 모바일 결제 문제를 해결하려면 KCP 인증키를 교체해야 하나요?
  공식 안내에 따르면 이번 수정 사항을 적용하기 위해 KCP 인증서나 인증키를 교체할 필요는 없습니다. 변경된 결제 라이브러리 파일을 정상적으로 적용하고 모바일 결제창 작동 여부를 확인하면 됩니다.
• 5.6.46 이하 버전에서도 패치 ZIP만 적용할 수 있나요?
  공식 패치 ZIP은 5.6.47을 기준으로 제공됩니다. 더 오래된 버전에서는 전체 배포본을 기준으로 필요한 변경 사항을 병합해야 합니다. 이전 버전의 DB 변경 작업과 사용자 정의 코드도 함께 확인해야 합니다.
• 이번 업데이트로 모든 모바일 결제 오류가 해결되나요?
  아닙니다. 이번 패치는 KCP REST API 모바일 거래등록 응답의 정상 결제창 주소를 허용하는 문제를 수정한 것입니다. 다른 결제 수단이나 별도의 설정 오류까지 모두 해결한다는 의미는 아닙니다.

그누보드 5.6.48 배포

이전 버전 함께 보기

그누보드 5.6.48를 확인하시는 분이라면 바로 이전 버전 흐름도 함께 보셔야 합니다. 패치 방향이 어떻게 이어졌는지 살펴보면 보안, 결제, 운영 안정성 변화가 더 또렷하게 정리됩니다.

• 그누보드 5.6.47 배포, KCP 연동·PG 승인정보 개선…결제 기능 강화
• 그누보드 5.6.46 업데이트, 쇼핑몰 DB 오류 잡았다…무엇이 달라졌나?
• 그누보드 5.6.45 배포, 비밀글 인증 방식 변경…업데이트 후 재인증 필수

모바일 결제와 로그인 안정성을 위한 업데이트

그누보드 5.6.48은 대규모 기능 추가보다 기존 쇼핑몰과 회원 서비스에서 발견된 문제를 해결하는 데 집중한 버전입니다.

NHN KCP REST API 모바일 결제창 연결 문제를 수정하면서 기존 주소 검증 조건을 유지했고, 회원정보가 존재하지 않는 로그인 세션도 정상적으로 정리하도록 개선했습니다.

운영 중인 사이트에 적용할 때는 현재 버전과 사용자 정의 코드, 기존 DB 업그레이드 상태를 먼저 확인해야 합니다.

특히 KCP REST API를 사용하는 영카트 쇼핑몰이라면 업데이트 후 모바일 결제창이 정상적으로 열리는지 반드시 점검하시기 바랍니다.