$ cd /errors
오류 해결 모음
오류 메시지보다 로그가 먼저입니다. 증상으로 찾은 뒤, 아래 공통 순서대로 확인하세요.
// find
증상으로 찾기
분류를 누르거나 메시지 일부를 검색하면 목록이 좁혀집니다.
9개
- 글쓰기
응답이 올바른 JSON 응답이 아닙니다
글을 저장할 때 REST API 응답에 PHP 경고가 섞이거나 보안 규칙이 막은 경우입니다.
관련 글 -> - 예약 · 크론
예약 글이 ‘예약을 놓침’ 으로 표시됨
방문자가 없어 WP-Cron 이 제때 돌지 않았습니다. 서버 크론으로 옮기면 해결됩니다.
관련 글 -> - 업로드
매달 1일에만 업로드가 멈춤
새 달 폴더를 만들 권한이 없을 때 생깁니다.
관련 글 -> - 예약 · 크론
해가 바뀌면 같은 자리에서 다시 멈춤
새 해 폴더 · 날짜 조건이 걸린 작업이 처음 실행될 때 생깁니다.
관련 글 -> - 로그인
이전 뒤 로그인하면 옛 도메인으로 이동
siteurl · home 값과 쿠키 도메인이 옛 주소로 남은 경우입니다.
관련 글 -> - 관리자
업데이트 뒤 관리자 메뉴만 작동하지 않음
자바스크립트 오류나 캐시된 옛 파일 때문인 경우가 많습니다.
관련 글 -> - 관리자
프런트엔드에 관리자 툴바가 안 보임
사용자 설정, 테마의 wp_footer 누락, 캐시를 차례로 봅니다.
관련 글 -> - 관리자
ads.txt 를 올렸는데 404
워드프레스가 아니라 웹서버 문서 루트를 먼저 확인합니다.
관련 글 -> - 로그인
jsDelivr SSL 오류로 사이트가 안 열림
외부 CDN 파일을 불러오지 못해 화면이 멈춘 경우의 임시 우회입니다.
관련 글 ->
// order
공통 확인 순서
어떤 오류든 이 순서로 보면 원인 후보가 빠르게 줄어듭니다.
- step 01
브라우저 콘솔
F12 의 Console · Network 에서 빨간 줄과 실패한 요청의 응답을 봅니다.
- step 02
PHP 에러 로그
같은 시각에 찍힌 Fatal · Warning 을 찾습니다.
grep -n 'PHP Fatal' /var/log/php-fpm/www-error.log | tail - step 03
플러그인 끄고 재현
모두 끈 뒤 증상이 사라지면 하나씩 켜 봅니다.
wp plugin deactivate --all - step 04
기본 테마로 재현
테마 functions.php 가 원인인지 가립니다.
wp theme activate twentytwentyfive - step 05
서버 설정 확인
권한, 업로드 한도, 보안 규칙(mod_security · WAF)을 봅니다.
ls -ld wp-content/uploads/$(date +%Y)
// logs
로그 파일 위치
배포판과 설정에 따라 경로가 다를 수 있습니다.
| 로그 | 무엇이 남는지 | 켜는 법 | 주의 |
|---|---|---|---|
| PHP 에러 로그 | Fatal · Warning · Notice | php-fpm 풀의 php_admin_value[error_log] | 화면 출력(display_errors)은 끕니다 |
| 웹서버 에러 로그 | 권한 · 설정 · 프록시 오류 | 기본으로 켜져 있음 | Apache 는 error_log, Nginx 는 error.log |
| 웹서버 접속 로그 | 요청 경로 · 응답 코드 · IP | 기본으로 켜져 있음 | 두 번 쌓이지 않는지 확인 |
| debug.log | 워드프레스 안의 오류 | WP_DEBUG · WP_DEBUG_LOG 를 true | 공개 폴더에 남으니 확인 뒤 끕니다 |
디버그 로그를 읽을 때
로그에 처음 찍힌 플러그인이 원인이 아닐 수 있습니다. 다른 코드가 남긴 잘못된 값을 그 플러그인이 마지막에 건드렸을 뿐일 때가 있습니다.
- - 같은 시각의 웹서버 로그와 맞춰 봅니다.
- - 의심 플러그인만 끄고 재현해 봅니다.
- - 자세한 사례: 디버그 로그가 범인을 잘못 지목할 때
// checklist
고치기 전 확인 목록
되돌릴 수 있어야 마음 놓고 고칠 수 있습니다.
- [ok]백업파일과 DB 를 함께
- [ok]스테이징에서 재현운영 사이트에서 바로 고치지 않기
- [ok]바꾼 내용 기록무엇을 언제 바꿨는지
- [ok]캐시 비우기페이지 · 객체 · CDN 캐시
- [ok]되돌리는 방법원래 값과 명령을 미리 적어 두기
// faq
오류 자주 묻는 질문
Q. 에러 로그 대부분이 제 코드가 아닙니다.
그렇습니다. 실제로 세어 보면 대부분 플러그인 · 테마의 Notice 입니다. 에러 로그를 열면 내 잘못은 몇 줄일까에 센 결과가 있습니다.
Q. functions.php 를 직접 고쳐도 되나요?
테마 업데이트 때 지워지고, 오타 하나로 사이트가 멈춥니다. 자식 테마나 작은 플러그인으로 넣으세요. 워드프레스 functions.php 직접 수정이 위험한 이유와 안전한 기능 추가 방법을 참고하세요.
Q. 업데이트 뒤 화면이 깨졌습니다.
캐시를 비우고, 콘솔 오류를 확인한 뒤, 플러그인을 하나씩 꺼 봅니다. 되돌릴 백업이 있으면 먼저 되살리고 원인을 찾습니다.