그누보드7 admin/boards/settings 404 페이지를 찾을 수 없습니다 > Info Tech

PHP 그누보드7 admin/boards/settings 404 페이지를 찾을 수 없습니다

페이지 정보

작성자 최고관리자 작성일 26-07-26 14:47 조회 7 댓글 1

본문

그누보드7 admin/boards/settings 404 페이지를 찾을 수 없습니다

그누보드 7 버전에서 admin/boards/settings 페이지가 404 에러를 일으키는 원인은라라벨(Laravel) 기반 코어의 라우트 캐시 문제이거나 웹 서버(Nginx/Apache)의 URL 재작성(Rewrite) 설정 누락때문입니다.

그누보드7은 이전 버전과 달리 라라벨과 리액트(React)를 기반으로 작동하므로 프레임워크 구조에 맞는 해결책이 필요합니다.

모듈 레이아웃 갱신 (가장 먼저 시도)

그누보드7 코어에서 게시판 모듈의 내부 경로(Route) 정보가 꼬였을 때 발생할 수 있습니다.

작동하는 다른 관리자 페이지(예: 메인 대시보드)에 먼저 접속합니다.
모듈 관리 > 게시판메뉴로 이동합니다.
게시판 우측에 있는 더보기 버튼( ⋮ )을 누른 후[레이아웃 갱신]을 클릭합니다.
완료 후 새로고침하여 admin/boards/settings 페이지에 다시 접속해 봅니다.

라라벨 캐시 및 자동 로드 초기화 (SSH 명령어 이용)

레이아웃 갱신으로 해결되지 않는다면 서버에 SSH로 접속하여 라라벨 터미널(Artisan) 명령어로 경로를 초기화해야 합니다. 그누보드7 설치 경로에서 다음 명령어들을 순서대로 실행하세요.

bash

                     # 1. 모든 캐시 파일 삭제
php artisan optimize:clear
# 2. 확장 모듈 자동 로드 갱신
php artisan extension:update-autoload
# 3. 패키지 디스커버리 정보 재구성
php artisan package:discover

코드를 사용할 때는 주의가 필요합니다.

그누보드7(Laravel 기반 오픈소스) 관리자 페이지에서 /admin/boards/settings 주소가 404 에러를 뱉는 문제는 웹 서버 라우팅 설정 미비 또는 데이터베이스(DB) 연결 실패로 인한 라우트 누락 때문에 발생합니다.

아래 해결 방법을 순서대로 확인해 보세요.

1. Nginx / Apache 웹 서버 라우팅 설정 (가장 유력)

그누보드7은 라라벨(Laravel) 프레임워크 기반이므로, 모든 요청을 index.php 로 모아주는 URL 재작성(Rewrite) 설정이 필수적입니다. 이 설정이 없으면 메인 페이지 외에 /admin 계열 주소는 전부 404 에러가 납니다.

Nginx를 사용하는 경우
Nginx 설정 파일( nginx.conf 또는 사이트 블록 설정)의 location / 블록에 아래 내용을 추가하고 Nginx를 재시작하세요.
nginx
location / { try_files $uri $uri/ /index.php?$query_string; }
코드를 사용할 때는 주의가 필요합니다.
Apache를 사용하는 경우
프로젝트 루트 디렉토리에 .htaccess 파일이 정상적으로 존재하는지, 웹 서버에서 AllowOverride All 설정이 켜져 있는지 확인하세요.

2. .env 파일의 DB 접속 정보 및 권한 확인

그누보드7은 실행 시점에 DB에서 모듈 설정을 읽어와 관리자 라우트(SPA 화면)를 동적으로 로드합니다.

.env 파일 내부의 DB_USERNAME , DB_PASSWORD 정보가 올바른지 점검하세요.
DB 계정이 root 이거나 접속 정보가 잘못되어 테이블을 정상적으로 읽지 못하면, 확장 모듈 로딩을 건너뛰어 /admin/boards 관련 라우트 자체가 생성되지 않습니다.

3. 라라벨 라우트 목록 점검

서버 터미널(CLI)에 접속할 수 있다면, 프로젝트 루트 디렉토리에서 아래 명령어를 입력하여 관리자 관련 라우트가 정상 생성되어 있는지 확인하세요.

bash

                                 php artisan route:list --path=admin -vv

코드를 사용할 때는 주의가 필요합니다.

출력 결과에 /admin/boards 나 /admin/{...} 형태의 라우트가 전혀 보이지 않는다면 2번 항목(DB 연결)이나 확장 모듈 설치 과정을 다시 점검해야 합니다.

댓글목록 1

최고관리자님의 댓글

최고관리자 작성일 26-07-28 07:46

가장 먼저 확인할 사항은 DB 계정이 root 이면 그누보드7은 보안상 404에러가 납니다. DB 계정을 새로 만들고 권한을 부여한 상태에서 .env파일에 새로운 DB계정에 대한 정보를 입력하고 접속하면 연결이 됩니다.