그누보드 짧은 주소(Short URL) 설정 시 오작동 해결 가이드
페이지 정보

본문
그누보드 운영 중 짧은 주소 설정 후 발생하는 404 오류나 오작동의 원인을 점검하고, 서버 환경에 맞는 해결 방법을 확인합니다.
짧은 주소 설정 시 404 Not Found 오류 원인 및 해결
그누보드에서 짧은 주소를 사용하도록 설정한 뒤 게시판에 접속할 때 404 Not Found 오류가 발생하는 것은 주로 웹서버 환경에서 URL 재작성 규칙(.htaccess)이 올바르게 적용되지 않았기 때문입니다.
주요 원인 및 확인 사항
- AllowOverride 설정 미흡: 아파치(Apache) 서버 환경에서 그누보드 설치 디렉터리에 대해
AllowOverride가 올바르게 설정되지 않은 경우.htaccess파일의 rewrite 규칙이 무시되어 짧은 주소 경로를 찾지 못하는 문제가 발생할 수 있습니다. - rewrite_module 비활성화: 아파치 서버의
rewrite_module이 비활성화되어 있으면 짧은 주소를 사용할 수 없습니다. - 하위 폴더 설치 시 경로 문제: 그누보드가 루트가 아닌 하위 디렉터리(예:
/g5/)에 설치된 경우.htaccess파일 내의RewriteBase경로 설정이 일치하지 않으면 오류가 발생할 수 있습니다.
다음 행동 및 조치
- 아파치 서버의
rewrite_module이 활성화되어 있는지 확인합니다. - 서버 설정 파일에서 그누보드 설치 디렉터리의
AllowOverride옵션이All로 설정되어 있는지 검토합니다. - 그누보드 설치 폴더에
.htaccess파일이 정상적으로 생성되었는지 확인합니다. 하위 디렉터리(예:/g5/)에 설치된 경우.htaccess파일 내RewriteBase /를RewriteBase /g5/와 같이 실제 설치 경로에 맞게 수정해야 합니다.
그누보드 짧은 주소 설정 시 오작동 해결 방법
그누보드5에서 짧은 주소(Short URL) 기능을 적용할 때 오작동이나 404 오류가 발생할 경우, 서버 환경과 설정 상태를 단계별로 점검해야 합니다.
1. Apache 서버 Rewrite 모듈 확인
관리자 페이지의 [기본환경설정] > [짧은주소] 항목에서 Apache 서버인 경우 rewrite_module이 비활성화되어 있으면 짧은 주소를 사용할 수 없으므로 활성화 여부를 먼저 확인해야 합니다.
2..htaccess 파일 및 RewriteBase 경로 확인
도메인 하위 디렉터리(예: http://도메인/g5/)에 그누보드를 설치했다가 루트로 이동하거나 하위 폴더에서 짧은 주소를 사용할 때 The requested URL /g5/bbs/board.php was not found on this server.와 같은 에러가 발생할 수 있습니다. 이 경우 도메인 루트 경로에 있는 .htaccess 파일의 설정을 확인하고 RewriteBase / 항목 및 경로 설정을 점검해야 합니다.
3. 디렉터리 권한 및 AllowOverride 설정 확인
웹 서버 설정에서 그누보드 디렉터리에 대해 AllowOverride가 설정되지 않아 짧은 주소가 정상 작동하지 않을 수 있으므로 서버 설정(예: Apache 사이트 설정 파일)을 함께 검토해야 합니다.
4. 글이름 설정 시 특수기호 예외 확인
짧은 주소 방식을 '글 이름'으로 설정했을 때 제목에 특수기호가 포함된 게시물이 '글이 존재하지 않는다'고 나오는 현상이 관찰될 수 있습니다. 이 경우 숫자로 설정하면 정상적으로 열리는지 비교하여 확인해 볼 수 있습니다.
짧은 주소 '글 이름' 설정 시 특수기호 포함 게시물 미조회 현상
그누보드5에서 짧은 주소 방식을 '글 이름'으로 설정했을 때 특수기호가 포함된 게시물이 조회되지 않고 '글이 존재하지 않다고 나옵니다'라는 오류가 발생하는 사례가 관찰됩니다.
원인 및 특성 파악
- 숫자 설정과의 차이: 짧은 주소 형태를 '숫자'로 설정했을 때는 모든 게시물이 정상적으로 열리지만, '글 이름'으로 설정한 경우에만 특정 제목 형태에서 문제가 발생합니다.
- 입력 사례: '안녕하세요' 같은 일반 텍스트 제목은 정상 접속이 가능한 반면, '안녕하세요!!'처럼 특수기호가 포함된 제목에서는 게시물이 존재하지 않는다는 메시지가 나타납니다.
다음 확인 사항 및 조치
- 특수기호가 포함된 제목에서 주소 변환 및
wr_seo_title필드 처리 시 발생하는 인식 오류 여부를 점검해야 합니다. - 문제가 지속될 경우 주소 형식을 '숫자'로 변경하여 정상적으로 조회되는지 확인하는 대안을 고려할 수 있습니다.
상황별 판단 및 행동 지침
- 짧은 주소 설정 후 404 오류 발생 시
- 선택 기준: 서버 환경이 Apache인지 Nginx인지 확인합니다. Apache라면
rewrite_module활성화 여부와.htaccess파일의RewriteBase경로가 실제 설치 위치와 일치하는지 우선 점검합니다. - 다음 행동: 관리자 페이지의 [기본환경설정]에서 짧은 주소 설정 상태를 확인하고, 서버 설정 파일에서
AllowOverride All이 적용되었는지 검토합니다.
- 선택 기준: 서버 환경이 Apache인지 Nginx인지 확인합니다. Apache라면
- '글 이름' 설정 시 특수기호 게시물 미조회 시
- 선택 기준: 게시물 제목에 특수기호가 포함되어 URL 인식 오류가 발생하는지 확인합니다.
- 다음 행동: 주소 형태를 '숫자'로 변경하여 정상 조회되는지 비교 테스트를 수행합니다.
실전 FAQ
- Q. 짧은 주소 설정 후 404 에러가 발생합니다.
- 대안: 서버가 하위 디렉터리에 설치된 경우
.htaccess파일 내RewriteBase /경로를 실제 설치 경로(예:/g5/)로 수정해야 합니다. 또한, 웹 서버 설정에서AllowOverride가None으로 되어 있으면.htaccess규칙이 무시되므로All로 변경이 필요합니다.
- 대안: 서버가 하위 디렉터리에 설치된 경우
- Q. '글 이름' 설정 시 특수기호가 포함된 게시물만 안 열립니다.
- 예외: '글 이름' 방식은 제목의 특수문자 처리 과정에서 인식 오류가 발생할 수 있습니다. 이 경우 '숫자' 방식을 사용하면 대부분의 게시물이 정상적으로 조회됩니다.
함께 보면 좋은 글
- 그누보드5 및 아미나 빌더 짧은 주소(Short URL) 설치 및 트러블슈팅 가이드
- 그누보드 5.3 스킨을 5.4 짧은 주소(pretty URL) 환경에 맞게 수정하는 방법
- 그누보드 짧은 주소 기능을 게시판 그룹 페이지에 적용하는 방법
참고자료
기타 참고자료
- sir.kr — 그누보드5 짧은주소 글이름 으로 설정후 오류 - SIR - 개발자 커뮤니티
- sir.kr — 짧은주소사용시 에러가 발생합니다 - SIR - 개발자 커뮤니티
- blog.buffashe.com — 그누보드 짧은 주소가 작동하지 않을 때 – buffashe's Blog
- sir.kr — 짧은 주소가 설정이 안되네요. ㅜㅜ - SIR - 개발자 커뮤니티
- sir.kr — 그누 5.4 최신버전 짧은주소가 적용이 안됩니다..ㅠㅠ - SIR - 개발자 커뮤니티
- sir.kr — 짧은주소가 적용이 안됩니다. - SIR - 개발자 커뮤니티
- sir.kr — 그누보드5 매뉴얼
- 다음글그누보드 최근글 및 게시판 목록에 스크랩 버튼 추가하기 26.11.06
댓글목록
등록된 댓글이 없습니다.