그누보드 운영 중 자주 발생하는 오류 5가지와 해결법
사이트가 갑자기 멈췄을 때, 당황하지 마시고 이 글부터 확인하세요. 20년 경력의 그누보드 전문가가 알려주는 즉시 해결 가이드입니다.
빈 화면, 에러 메시지, 한글 깨짐… 어디서부터 손대야 할까요?
그누보드로 사이트를 운영하다 보면 한 번씩 마주치는 순간이 있습니다.
사이트에 접속했는데 빈 화면만 나오거나, “500 Internal Server Error” 같은 영문 에러 메시지가 뜨거나, 한글이 모두 ???로 깨져 보이는 상황 말이죠.
이런 순간, 가장 큰 문제는 “어디서부터 손대야 할지 모른다” 는 것입니다. 관리자 페이지에도 못 들어가니 더 막막하죠.
20년 동안 그누보드 사이트를 만들고 운영하면서, 가장 자주 보는 오류 5가지와 그 해결 방법을 정리했습니다.
이 글 하나로 대부분의 문제를 해결하실 수 있을 거예요.
1. 빈 화면만 나옵니다 (White Screen of Death)
가장 당황스러운 상황입니다. 사이트에 접속하면 아무것도 없는 흰 화면. 에러 메시지조차 없어서 “사이트가 사라진 건가” 싶기까지 합니다.
주요 원인
- PHP 코드 오류 (최근 수정한 파일에 문제)
- 메모리 한도 초과
- 플러그인 또는 스킨 충돌
- PHP 버전 호환성 문제
해결 방법
1단계: 에러 메시지 확인하기
빈 화면은 실은 “에러가 있는데 표시 안 한 상태” 입니다. config.php 파일에 다음 코드를 임시로 추가하면 실제 에러 메시지가 나타납니다.
ini_set('display_errors', 1);
error_reporting(E_ALL);2단계: 에러 메시지에 따라 대응
Fatal error→ 해당 파일의 PHP 문법 오류 확인Out of memory→ 호스팅의 PHPmemory_limit증가 필요Cannot redeclare→ 같은 함수가 중복 선언됨, 최근 추가한 코드 확인
3단계: 최근 변경 사항 되돌리기
문제가 발생한 시점에 무엇을 변경했는지 떠올려보세요.
스킨 수정, 플러그인 설치, 코드 수정 – 가장 의심스러운 부분을 원래대로 돌리면 80%는 해결됩니다.
예방 팁
수정 작업 전에 반드시 백업하세요.
한 줄의 코드 수정도 백업 없이는 위험합니다.
2. 500 Internal Server Error
영문 메시지가 무서워 보이지만, 사실 가장 흔한 오류 중 하나입니다.
주요 원인
.htaccess파일 손상 또는 잘못된 설정- 파일 권한 문제 (특히 644, 755 권한 어긋남)
- PHP 메모리 또는 실행 시간 초과
- 호스팅의
mod_security등 보안 모듈 차단
해결 방법
1단계: .htaccess 점검
가장 자주 원인이 되는 파일입니다.
- FTP로 접속해 사이트 루트 폴더의
.htaccess파일 백업 - 파일을 임시로
.htaccess_backup으로 이름 변경 - 사이트 다시 접속 → 정상이면
.htaccess문제 확인
2단계: 파일 권한 확인
- 폴더: 755
- 파일: 644
config.php: 600 (보안상 더 엄격하게)
FTP 프로그램(FileZilla 등)에서 우클릭 → 권한 변경.
예방 팁
.htaccess 파일은 수정 전 반드시 백업.
한 글자 오타로도 전체 사이트가 멈출 수 있습니다.
3. 데이터베이스 연결 오류
“Error establishing a database connection” 같은 메시지가 나타나면 DB 문제입니다.
주요 원인
- DB 서버 일시적 다운
config.php의 DB 정보 잘못됨- DB 사용량 한도 초과 (호스팅 정책)
- DB 비밀번호 변경 후 미반영
해결 방법
1단계: 호스팅 콘솔에서 DB 상태 확인
Cafe24 호스팅 관리자 → DB 관리 → 정상 작동 여부 확인.
2단계: config.php 정보 확인
define('G5_MYSQL_HOST', 'localhost');
define('G5_MYSQL_USER', 'DB사용자명');
define('G5_MYSQL_PASSWORD', 'DB비밀번호');
define('G5_MYSQL_DB', 'DB이름');호스팅 콘솔의 DB 정보와 정확히 일치하는지 확인.
그누보드5의 경우 data 폴더안에 dbconfig.php 파일로 존재.
3단계: DB 용량 확인
DB 사용량이 한도에 도달하면 연결 거부됩니다.
호스팅 콘솔에서 DB 용량 확인 후 필요시 정리 또는 업그레이드.
예방 팁
config.php 백업은 반드시 별도로 보관.
이 파일이 손상되면 사이트 전체가 멈춥니다.
4. 한글이 모두 깨집니다 (???)
한글이 ???나 깨진 문자로 표시되는 인코딩 문제입니다.
주요 원인
- DB 캐릭터셋이 UTF-8이 아님
- 파일 자체가 UTF-8로 저장되지 않음
- DB 연결 시 캐릭터셋 미지정
- 그누보드 외 다른 시스템 연동 시 인코딩 불일치
해결 방법
1단계: DB 캐릭터셋 확인
phpMyAdmin 접속 → DB 선택 → “Operations” 또는 “구조” 탭 → Collation이 utf8mb4_general_ci 또는 utf8_general_ci인지 확인.
2단계: 테이블 캐릭터셋 변경
각 테이블이 같은 UTF-8 계열인지 확인.
불일치한 테이블은 변경 필요.
3단계: 파일 인코딩 확인
수정한 파일이 UTF-8 (BOM 없음)으로 저장됐는지 확인.
Notepad++, VS Code 같은 에디터에서 인코딩 확인 가능.
예방 팁
새 그누보드 설치 시 처음부터 UTF-8 (utf8mb4) 환경 구축.
EUC-KR 같은 옛 인코딩은 사용하지 마세요.
5. 파일 업로드가 안 됩니다
게시판에 이미지나 파일을 올릴 때 실패하는 상황입니다.
주요 원인
- 파일 크기 한도 초과 (PHP
upload_max_filesize) - 업로드 폴더 권한 문제 (
data/file/등) - 호스팅 디스크 용량 부족
- 그누보드 환경 설정의 업로드 제한
해결 방법
1단계: 그누보드 관리자 설정 확인
관리자 → 환경설정 → 게시판 설정 → 첨부파일 크기 한도 확인.
2단계: PHP 설정 확인
php.ini 또는 .htaccess에서:
upload_max_filesize = 50M(또는 원하는 크기)post_max_size = 50Mmax_execution_time = 300
3단계: 폴더 권한 확인
data/file/ 폴더 권한이 707 또는 755인지 확인. 쓰기 권한이 없으면 업로드 실패.
4단계: 디스크 용량 확인
호스팅 콘솔에서 디스크 사용량 확인. 90% 이상이면 위험.
예방 팁
정기적인 디스크 정리.
사용하지 않는 첨부파일 주기적 삭제.
오류를 예방하는 5가지 습관
지금까지 해결법을 알아봤지만, 가장 좋은 건 오류를 예방하는 것입니다.
1. 정기 백업 : 최소 주 1회 자동 백업 설정 (Cafe24 호스팅의 자동 백업 또는 별도 백업 도구)
2. 수정 전 백업 : 작은 수정도 반드시 백업 후 진행
3. 테스트 서버 활용 : 본격 사이트 수정 전 테스트 환경에서 검증
4. 에러 로그 모니터링 : 정기적으로 호스팅 에러 로그 확인
5. 즉시 알림 시스템 : 오류 발생 즉시 알림 받는 시스템 구축
정리
그누보드 오류는 두렵게 보이지만, 대부분 정해진 패턴이 있습니다.
이 글의 5가지 오류와 해결법만 알아두셔도 운영 중 마주치는 문제의 80%는 스스로 해결하실 수 있습니다.
하지만 해결이 어렵거나 시간이 부족하시다면 전문가의 도움을 받는 것도 좋은 선택입니다.
WizardOfCode는 20년의 그누보드 운영 경험으로 신속하고 정확한 문제 해결을 도와드립니다.
또한, 오류 발생을 미리 알 수 있도록 무료 모듈을 곧 배포할 예정입니다.
사이트에 오류가 발생하면 텔레그램으로 즉시 알림을 받을 수 있는 도구이니, 관심 있으시면 곧 wizardofcode.kr에서 만나보세요.
🛠️ 그누보드 문제 해결이 필요하신가요?
20년 경력의 전문가가 답변드립니다.