그누보드 5.6.49 공개, 엑셀배송 막히던 오류 수정…내 쇼핑몰도 해당될까?

그누보드 5.6.49 배포, 엑셀배송처리 오류 무엇이 달라졌나요?

그누보드 5.6.49가 2026년 11월 11일 공식 배포됐습니다. 이번 업데이트는 영카트 쇼핑몰 관리자에서 배송처리용 엑셀파일을 업로드할 때 보안 검증으로 요청이 차단되던 문제를 해결한 것이 핵심입니다. 새로운 DB 변경은 없으며, 기존 보안 검증을 유지하면서 정상적인 배송정보 등록이 가능하도록 수정됐습니다.

SIR에서 공개한 공식 배포 내용에 따르면, 이번 수정은 엑셀배송처리 화면에서 필요한 보안 토큰이 전달되지 않던 문제를 바로잡는 데 집중했습니다. 영카트 쇼핑몰을 운영하면서 주문 배송정보를 엑셀로 일괄 처리하는 관리자라면 변경 사항과 업데이트 후 확인할 내용을 살펴보시는 것이 좋겠습니다.

그누보드 5.6.49 업데이트 핵심 내용

이번 버전은 새로운 기능을 대규모로 추가하기보다 기존 배송관리 기능의 오류를 바로잡는 유지보수 업데이트입니다.

이번 패치는 배송정보 등록 과정에서 발생하던 오류를 수정하면서도 관리자 요청에 대한 보안 검사를 그대로 유지했다는 점이 중요합니다. 실제 수정된 코드와 변경 사항은 GitHub에서 제공하는 그누보드 5.6.48→5.6.49 변경 비교를 통해 직접 확인하실 수 있습니다.

엑셀배송처리 오류는 왜 발생했나요?

영카트 쇼핑몰에서는 주문내역에서 배송처리용 엑셀파일을 내려받은 뒤 택배사와 송장번호를 입력하고 다시 업로드하여 배송정보를 일괄 등록할 수 있습니다.

그런데 기존 버전에서는 엑셀파일에 배송정보를 정상적으로 입력하더라도 등록 과정에서 요청이 차단되는 문제가 발생할 수 있었습니다.

문제의 원인은 엑셀파일 자체나 송장번호 입력 방식이 아니라 관리자 요청을 검증하는 보안 토큰 처리에 있었습니다.

보안 강화 과정에서 배송정보 등록 요청을 검사하는 기능이 추가됐지만, 엑셀 업로드 화면에서 검증에 필요한 토큰을 전달하는 코드가 빠져 있었습니다.

이 때문에 정상적인 관리자가 배송정보를 등록하더라도 처리 페이지에서는 필요한 토큰을 확인하지 못해 요청을 거부하는 상황이 발생했습니다.

오류가 발생하던 처리 과정

• 쇼핑몰 관리자가 주문내역에서 배송처리용 엑셀파일을 내려받습니다.
• 엑셀파일에 택배사와 송장번호를 입력합니다.
• 수정한 엑셀파일을 배송처리 화면에서 업로드합니다.
• 업로드 화면에서 필요한 보안 토큰이 전달되지 않습니다.
• 처리 페이지의 보안 검증에서 요청이 차단되어 배송정보 등록이 완료되지 않습니다.

이번 업데이트는 이러한 처리 흐름에서 누락된 토큰 전달 기능을 보완하여 정상적인 업로드 요청이 통과하도록 수정했습니다.

보안 토큰 검증을 유지한 이유

그누보드 5.6.49에서 중요한 부분은 오류를 해결하기 위해 기존 보안 검사를 제거하지 않았다는 점입니다.

관리자 기능에서 사용하는 보안 토큰은 요청이 정상적인 관리 화면에서 전달됐는지 확인하는 역할을 합니다. 특히 주문정보와 배송상태를 변경하는 기능에서는 이러한 검증이 중요합니다.

이번 패치에서는 엑셀 업로드 폼에 토큰을 추가하면서 배송정보 처리 페이지의 기존 check_admin_token() 검증을 유지했습니다.

정상 요청과 비정상 요청 검증

공식 패치 노트에서는 다음과 같은 상황을 확인하는 회귀 검사가 추가됐다고 안내했습니다.

• 정상적인 보안 토큰을 전달한 요청은 통과하는지 확인합니다.
• 보안 토큰이 비어 있는 요청은 거부하는지 확인합니다.
• 변조된 보안 토큰이 전달되면 차단하는지 확인합니다.
• 이미 사용한 토큰의 재사용 요청을 거부하는지 확인합니다.
• 이전에 열어둔 화면에서 전달되는 오래된 토큰을 거부하는지 확인합니다.

여기서 주의하실 부분은 배송정보 등록 오류를 해결하려고 개발자가 임의로 check_admin_token() 검증 코드를 삭제해서는 안 된다는 것입니다.

공식 수정 방식은 검증 기능을 없애는 것이 아니라 업로드 화면에서 필요한 토큰을 정상적으로 전달하도록 보완하는 것입니다.

수정 파일과 개발자가 확인할 사항

이번 오류의 직접적인 수정 대상은 다음 파일입니다.

adm/shop_admin/orderdelivery.php

해당 파일의 엑셀 업로드 폼에 보안 토큰을 추가하는 방식으로 문제가 수정됐습니다.

배송정보를 실제로 처리하는 페이지인 orderdeliveryupdate.php에는 기존 관리자 토큰 검증이 유지됩니다.

그누보드 원본을 수정하여 사용하는 사이트라면 공식 수정 파일을 무조건 덮어쓰기보다 기존 사용자 정의 코드와 변경 사항을 먼저 비교하는 것이 좋겠습니다.

특히 관리자 화면에 별도 배송관리 기능, 추가 입력 항목, 송장번호 처리 로직 등을 구현했다면 원본 코드가 유지되는지 확인해야 합니다.

반대로 배송처리 기능을 별도로 수정하지 않은 5.6.48 환경에서는 공식 패치 ZIP을 적용하는 방법을 사용할 수 있습니다.

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

SIR의 공식 안내에서는 업데이트 전에 파일과 데이터베이스를 백업하고 사이트 이용을 일시적으로 중지하도록 권장하고 있습니다.

실제 운영 중인 쇼핑몰이라면 주문 접수와 배송정보 변경이 동시에 발생하지 않도록 작업 시간을 조정하는 것이 안전합니다.

1. 파일과 DB 백업

먼저 FTP 또는 서버 관리 도구에서 현재 운영 중인 사이트 파일을 백업하고 MySQL 데이터베이스도 별도로 백업합니다.

추가로 수정한 관리자 파일이나 쇼핑몰 관련 사용자 정의 코드가 있다면 해당 파일도 확인해 두시는 것이 좋겠습니다.

2. 현재 설치 버전 확인

현재 사이트가 5.6.48이라면 공식 배포 게시물에 포함된 패치 ZIP을 사용할 수 있습니다.

5.6.47 이하의 이전 버전이라면 5.6.49 전체 배포본을 기준으로 기존 수정 사항을 비교하고 병합해야 합니다.

이 과정에서는 기존 data 디렉터리와 DB 설정을 보존해야 합니다. 전체 배포본을 적용한다는 이유로 운영 데이터나 사이트별 설정을 덮어쓰지 않도록 주의하셔야 합니다.

3. 수정 파일 적용

이번 엑셀배송처리 오류의 수정 파일은 adm/shop_admin/orderdelivery.php입니다.

사용자 정의 코드가 없는 경우 공식 패치에 포함된 수정 사항을 적용할 수 있으며, 별도 수정 사항이 있다면 변경된 부분을 비교하여 병합하는 방식이 적합합니다.

이때 orderdeliveryupdate.php의 보안 토큰 검증은 삭제하지 않아야 합니다.

4. DB 업그레이드 여부 확인

그누보드 5.6.49에서는 새로운 DB 변경이 없으므로 이번 버전 자체를 위한 별도의 DB 업그레이드는 필요하지 않습니다.

다만 이전 버전에서 필요한 DB 업그레이드를 완료하지 않았다면 관리자 화면의 DB 업그레이드 기능을 확인하여 미완료 작업을 처리해야 합니다.

따라서 ‘5.6.49에서 DB 업그레이드가 필요 없다’는 안내가 이전 버전의 미완료 업그레이드까지 생략해도 된다는 의미는 아닙니다.

5. PHP 코드 캐시 및 배송처리 확인

PHP OPcache 등 코드 캐시를 사용하는 서버에서는 변경한 PHP 파일이 실제 실행 환경에 반영됐는지 확인해야 합니다.

또한 기존에 열어두었던 엑셀배송처리 화면은 닫고 새로 열어야 합니다.

이전 화면에서 발급된 토큰은 새 요청에 사용할 수 없을 수 있으므로 반드시 새 화면에서 정상적인 업로드를 테스트하는 것이 중요합니다.

엑셀배송처리 정상 작동 확인 방법

업데이트 파일을 적용했다면 배송정보가 정상적으로 등록되는지 직접 확인하시는 것이 좋겠습니다.

다음과 같은 순서로 테스트할 수 있습니다.

• 영카트 쇼핑몰 관리자에서 주문내역 화면에 접속합니다.
• 배송처리용 엑셀파일을 내려받습니다.
• 테스트할 주문의 택배사와 송장번호를 입력합니다.
• Excel 97–2003 통합문서 형식인 .xls 파일로 준비합니다.
• 기존 엑셀배송처리 창을 닫고 새로 열어 파일을 업로드합니다.
• 보안 토큰 오류 없이 요청이 정상적으로 처리되는지 확인합니다.
• 주문내역에 택배사와 송장번호가 실제로 반영됐는지 확인합니다.

테스트할 때는 실제 고객 주문정보가 변경되지 않도록 테스트 주문을 활용하거나 배송정보 변경에 문제가 없는 주문을 선택하는 것이 좋겠습니다.

업로드가 정상적으로 완료됐다는 메시지만 확인하는 것보다 주문 상세정보에 배송정보가 올바르게 저장됐는지 확인하는 것이 중요합니다.

이전 버전에서 달라진 업데이트 흐름

최근 그누보드 5.6 버전은 쇼핑몰 결제 연동과 운영 안정성을 중심으로 수정이 이어지고 있습니다.

5.6.47과 5.6.48에서는 결제 연동 관련 수정이 중심이었다면, 이번 5.6.49에서는 관리자의 배송업무에서 발생하는 오류를 해결하는 방향으로 개선됐습니다.

결제 기능을 사용하지 않는 일반 게시판 사이트에서는 이번 변경 사항의 직접적인 영향이 제한적일 수 있습니다. 반면 영카트에서 배송정보를 엑셀파일로 일괄 등록하는 쇼핑몰이라면 업데이트 필요성을 확인할 만한 내용입니다.

자주 묻는 질문

• 그누보드 5.6.49에서 DB 업그레이드가 필요한가요?
  아닙니다. 이번 버전에는 새로운 DB 변경이 없어 별도의 DB 업그레이드가 필요하지 않습니다. 다만 이전 버전에서 완료하지 않은 DB 업그레이드 항목이 있다면 관리자 화면에서 확인하고 처리해야 합니다.
• 엑셀배송처리 기능을 사용하지 않아도 업데이트해야 하나요?
  이번 패치의 직접적인 수정 대상은 영카트 엑셀배송처리 기능입니다. 해당 기능을 사용하지 않는 사이트에서는 직접적인 영향이 제한적일 수 있습니다. 다만 현재 설치 버전과 누적 업데이트 상태를 확인한 뒤 적용 여부를 판단하시는 것이 좋겠습니다.
• 5.6.48 사용자는 어떤 파일을 적용하면 되나요?
  공식 배포 게시물에 포함된 5.6.48 기준 패치 ZIP을 사용할 수 있습니다. 수정 파일은 adm/shop_admin/orderdelivery.php이며, 기존 사용자 정의 코드가 있다면 변경 사항을 비교하여 적용하셔야 합니다.
• 업데이트 후에도 보안 토큰 오류가 발생하면 어떻게 하나요?
  먼저 기존 엑셀배송처리 창을 닫고 새로 열어 다시 시도해 보시기 바랍니다. 이후 수정 파일의 서버 반영 여부와 PHP 코드 캐시 상태를 확인하는 것이 좋겠습니다. 보안 토큰 검증 코드를 임의로 제거하는 방식은 피해야 합니다.
• 엑셀파일 형식은 무엇을 사용해야 하나요?
  공식 업데이트 안내에서는 Excel 97–2003 통합문서 형식인 .xls 파일로 업로드를 확인하도록 안내하고 있습니다. 따라서 배송처리용 엑셀파일을 해당 형식으로 준비하여 정상 등록 여부를 점검하시는 것이 좋겠습니다.
• PHP 버전도 함께 변경해야 하나요?
  이번 5.6.49 배포 안내에는 엑셀배송처리 오류 수정과 관련하여 별도의 PHP 버전 변경 요구가 명시돼 있지 않습니다. PHP 8.4 등 특정 환경에서의 호환성이 이번 패치로 모두 검증됐다는 뜻은 아니므로, 현재 운영 환경에서 별도 테스트를 진행하는 것이 안전합니다.

그누보드 5.6.49 배포

이전 버전 함께 보기

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

• 그누보드 5.6.48 업데이트, 모바일 결제 오류 해결…운영자 필수 확인
• 그누보드 5.6.47 배포, KCP 연동·PG 승인정보 개선…결제 기능 강화
• 그누보드 5.6.46 업데이트, 쇼핑몰 DB 오류 잡았다…무엇이 달라졌나?

마무리하며

그누보드 5.6.49는 영카트 관리자에서 발생하던 엑셀배송처리 오류를 해결한 업데이트입니다. 업로드 화면에서 누락된 보안 토큰을 추가하고 기존 검증 기능을 유지하여 정상적인 배송정보 등록이 가능하도록 개선했습니다.

이번 버전 자체의 DB 업그레이드는 필요하지 않으며 삭제 대상 파일도 없습니다. 5.6.48 사용자는 공식 패치를 적용할 수 있지만, 이전 버전이나 사용자 정의 코드가 포함된 사이트에서는 변경 사항을 비교하고 병합해야 합니다.

쇼핑몰을 운영하신다면 업데이트 전 백업을 완료하고 적용 후에는 엑셀배송처리 창을 새로 열어 송장번호와 택배사 정보가 정상적으로 반영되는지 확인하시기 바랍니다.