확인과 문제 해결 자주 막히는 곳
페이지 정보
본문
설치하다 막혔을 때 먼저 볼 표입니다. 위에서부터 차례로 확인하세요.
증상별로 찾기
| 증상 | 가장 흔한 이유 | 해결 |
|---|---|---|
| 테마를 바꿨는데 예전 화면이 그대로 | 브라우저에 예전 화면이 남아 있음 | 새로고침(Ctrl + F5), 또는 시크릿 창에서 열기 |
| 관리자 테마 목록에 Next.js Default 가 없음 | theme/nextjs_default/ 가 제자리에 없음 |
3편 "서버에 올리기"에서 위치 확인 |
첫 화면은 뜨는데 /free 같은 주소가 404 |
주소 규칙(rewrite)이 반영되지 않음 | Apache: .htaccess 경고가 떴는지 확인하고 설정 코드를 직접 넣기. nginx: 짧은 주소 설정의 Nginx 코드를 넣었는지 확인 |
Apache 인데 .htaccess 를 넣어도 404 |
서버가 .htaccess 를 무시하도록 설정됨(AllowOverride) |
호스팅 업체에 ".htaccess 의 mod_rewrite 사용" 가능 여부 문의 |
/api/v1/status 가 404 |
api 폴더 위치가 틀렸거나 nginx 규칙 없음 |
api 가 common.php 와 같은 자리인지 확인, nginx 는 짧은 주소 설정 코드 반영 |
/api/v1/status 에서 schema 가 false |
새 기능 표가 아직 없음 | 최고관리자로 /adm/dbupgrade.php 실행 |
| 화면에 "오류가 발생했습니다" | 업데이트 직후 예전 화면 조각과 새 화면이 섞임 | 새로고침. 대부분 한 번 새로고침하면 사라집니다 |
| (nginx, 하위 폴더) 화면은 뜨는데 링크가 깨짐 | /_next/ 파일을 테마 폴더에서 직접 내보냄 |
alias · try_files 로 내보내는 설정을 빼고 짧은 주소 설정 코드만 쓰기 |
| 하얀 화면 / 500 오류 | PHP 버전이 낮거나 PHP 오류 | 호스팅의 PHP 버전을 7.4 이상으로, 점검 페이지의 PHP 항목 확인 |
그래도 안 되면
nextjs-install/check.php (최고관리자로 로그인한 상태)를 열어 빨간 줄을 확인하세요. 대부분의 설치 문제는 여기서 드러납니다.
그래도 풀리지 않으면 GitHub 에 질문을 남겨 주세요.
https://github.com/gnuboard/gnuboard5-nextjs/issues
질문에 함께 적어 주시면 빨리 답할 수 있는 것:
- 그누보드 버전, PHP 버전
- 웹서버 종류(Apache / nginx)와 호스팅 업체
- 루트 설치인지 하위 폴더 설치인지
- 어느 단계에서 무엇이 보였는지 (오류 문구, 화면 캡처)
비밀번호, DB 정보,
.env·config.php의 내용은 절대 올리지 마세요. 캡처에 들어가 있다면 가리고 올려 주세요.
확인표
- ☐ 증상 표에서 내 경우를 찾아 해결했다, 또는
- ☐ 필요한 정보를 모아 Issues 에 질문을 남겼다
- 이전글잘 됐는지 확인하기 26.09.30
댓글목록
등록된 댓글이 없습니다.