$ cd /errors

오류 해결 모음

오류 메시지보다 로그가 먼저입니다. 증상으로 찾은 뒤, 아래 공통 순서대로 확인하세요.

// find

증상으로 찾기

분류를 누르거나 메시지 일부를 검색하면 목록이 좁혀집니다.

9개

  • 글쓰기

    응답이 올바른 JSON 응답이 아닙니다

    글을 저장할 때 REST API 응답에 PHP 경고가 섞이거나 보안 규칙이 막은 경우입니다.

    관련 글 ->
  • 예약 · 크론

    예약 글이 ‘예약을 놓침’ 으로 표시됨

    방문자가 없어 WP-Cron 이 제때 돌지 않았습니다. 서버 크론으로 옮기면 해결됩니다.

    관련 글 ->
  • 업로드

    매달 1일에만 업로드가 멈춤

    새 달 폴더를 만들 권한이 없을 때 생깁니다.

    관련 글 ->
  • 예약 · 크론

    해가 바뀌면 같은 자리에서 다시 멈춤

    새 해 폴더 · 날짜 조건이 걸린 작업이 처음 실행될 때 생깁니다.

    관련 글 ->
  • 로그인

    이전 뒤 로그인하면 옛 도메인으로 이동

    siteurl · home 값과 쿠키 도메인이 옛 주소로 남은 경우입니다.

    관련 글 ->
  • 관리자

    업데이트 뒤 관리자 메뉴만 작동하지 않음

    자바스크립트 오류나 캐시된 옛 파일 때문인 경우가 많습니다.

    관련 글 ->
  • 관리자

    프런트엔드에 관리자 툴바가 안 보임

    사용자 설정, 테마의 wp_footer 누락, 캐시를 차례로 봅니다.

    관련 글 ->
  • 관리자

    ads.txt 를 올렸는데 404

    워드프레스가 아니라 웹서버 문서 루트를 먼저 확인합니다.

    관련 글 ->
  • 로그인

    jsDelivr SSL 오류로 사이트가 안 열림

    외부 CDN 파일을 불러오지 못해 화면이 멈춘 경우의 임시 우회입니다.

    관련 글 ->

// order

공통 확인 순서

어떤 오류든 이 순서로 보면 원인 후보가 빠르게 줄어듭니다.

  1. step 01

    브라우저 콘솔

    F12 의 Console · Network 에서 빨간 줄과 실패한 요청의 응답을 봅니다.

  2. step 02

    PHP 에러 로그

    같은 시각에 찍힌 Fatal · Warning 을 찾습니다.

    grep -n 'PHP Fatal' /var/log/php-fpm/www-error.log | tail
  3. step 03

    플러그인 끄고 재현

    모두 끈 뒤 증상이 사라지면 하나씩 켜 봅니다.

    wp plugin deactivate --all
  4. step 04

    기본 테마로 재현

    테마 functions.php 가 원인인지 가립니다.

    wp theme activate twentytwentyfive
  5. step 05

    서버 설정 확인

    권한, 업로드 한도, 보안 규칙(mod_security · WAF)을 봅니다.

    ls -ld wp-content/uploads/$(date +%Y)

// logs

로그 파일 위치

배포판과 설정에 따라 경로가 다를 수 있습니다.

로그무엇이 남는지켜는 법주의
PHP 에러 로그Fatal · Warning · Noticephp-fpm 풀의 php_admin_value[error_log]화면 출력(display_errors)은 끕니다
웹서버 에러 로그권한 · 설정 · 프록시 오류기본으로 켜져 있음Apache 는 error_log, Nginx 는 error.log
웹서버 접속 로그요청 경로 · 응답 코드 · IP기본으로 켜져 있음두 번 쌓이지 않는지 확인
debug.log워드프레스 안의 오류WP_DEBUG · WP_DEBUG_LOG 를 true공개 폴더에 남으니 확인 뒤 끕니다
[warn]

디버그 로그를 읽을 때

로그에 처음 찍힌 플러그인이 원인이 아닐 수 있습니다. 다른 코드가 남긴 잘못된 값을 그 플러그인이 마지막에 건드렸을 뿐일 때가 있습니다.

// checklist

고치기 전 확인 목록

되돌릴 수 있어야 마음 놓고 고칠 수 있습니다.

  • [ok]백업파일과 DB 를 함께
  • [ok]스테이징에서 재현운영 사이트에서 바로 고치지 않기
  • [ok]바꾼 내용 기록무엇을 언제 바꿨는지
  • [ok]캐시 비우기페이지 · 객체 · CDN 캐시
  • [ok]되돌리는 방법원래 값과 명령을 미리 적어 두기

// faq

오류 자주 묻는 질문

Q. 에러 로그 대부분이 제 코드가 아닙니다.

그렇습니다. 실제로 세어 보면 대부분 플러그인 · 테마의 Notice 입니다. 에러 로그를 열면 내 잘못은 몇 줄일까에 센 결과가 있습니다.

Q. functions.php 를 직접 고쳐도 되나요?

테마 업데이트 때 지워지고, 오타 하나로 사이트가 멈춥니다. 자식 테마나 작은 플러그인으로 넣으세요. 워드프레스 functions.php 직접 수정이 위험한 이유와 안전한 기능 추가 방법을 참고하세요.

Q. 업데이트 뒤 화면이 깨졌습니다.

캐시를 비우고, 콘솔 오류를 확인한 뒤, 플러그인을 하나씩 꺼 봅니다. 되돌릴 백업이 있으면 먼저 되살리고 원인을 찾습니다.

$ ls /tag/오류 해결

오류 해결 글 모아 보기

확인 순서대로 푼 오류 기록을 모았습니다. 같은 오류인데 해결되지 않으면 문의하기로 알려 주세요.