그누보드 DB 이전/업그레이드 오류 해결 가이드
그누보드5(Gnuboard5)를 최신 버전으로 판올림하거나 호스팅 서버를 이전한 직후, 게시판에서 글쓰기 버튼을 눌렀을 때 "테이블이 존재하지 않습니다" 또는 "SQL 오류(1054 Unknown column ...)"가 발생하며 글 저장이 차단되는 경우가 빈번합니다. 이는 신규 버전의 DB 스키마(컬럼 및 인덱스)가 동기화되지 않아 생기는 현상으로, 관리자 모드의 'DB 업그레이드' 기능을 통해 1분 만에 완벽 복구할 수 있습니다.
그누보드 5.3~5.5 전체 대응 | 원클릭 스키마 자동 패치 | 기존 데이터 손실 0%
▲ 그누보드 관리자 페이지 'DB 업그레이드 완료' 화면
DB 스키마 복구 4단계 해결법
1단계: 최고관리자 로그인
그누보드 관리자 계정(최고관리자 권한)으로 사이트에 정상 로그인합니다.
2단계: DB 업그레이드 URL 접속
브라우저 주소창에 직접 http://내도메인/adm/dbupgrade.php를 입력하고 엔터를 누릅니다.
3단계: 자동 스키마 패치 실행
화면에 누락된 테이블 필드, 인덱스 자동 생성 쿼리가 순차적으로 실행되며 "DB 업그레이드가 완료되었습니다" 문구가 뜹니다.
4단계: 게시판 글쓰기 재검증
오류가 났던 게시판으로 돌아가 [글쓰기]를 누르고 테스트 게시글이 에러 없이 깔끔하게 저장되는지 확인합니다.
자주 묻는 질문 (FAQ)
Q. DB 업그레이드를 실행하면 기존 게시글 데이터가 삭제되나요?
전혀 삭제되지 않습니다. dbupgrade.php 스크립트는 기존 데이터를 건드리지 않고 신규 버전에 필요한 신규 컬럼(예: wr_seo_title 등)과 인덱스만 ALTER TABLE로 덧붙여주는 안전한 작업입니다.
Q. 특정 게시판 테이블 자체가 아예 없을 때는 어떻게 하나요?
관리자 페이지 > [게시판 관리] 목록에서 해당 게시판의 [수정]을 누른 뒤 아무 항목도 수정하지 않고 그대로 [확인]을 누르면, 그누보드 내부 로직(board_form_update.php)이 누락된 `g5_write_{bo_table}` 테이블을 자동으로 신규 생성합니다.
Q. 일반 사용자가 dbupgrade.php에 접근할 수 있나요?
아닙니다. 파일 최상단에 if (!$is_admin == 'super') 보안 체크가 내장되어 있어, 최고관리자가 아닌 일반 사용자나 비회원이 접속하면 즉시 메인 페이지로 튕겨 나갑니다.