XAMPP에서 404 오류 또는 JSON 응답 오류 해결법

 

 XAMPP를 써본 적 있다면, 로컬에서 개발하다 갑자기 404 오류나 "유효한 JSON 응답이 아닙니다"라는 문구를 본 적 있을 거야. 이게 왜 뜨는지, 어떻게 고칠 수 있는지 저랑 천천히(!) 짚어보자구요.

 

 

 

 

404 오류 해결 체크리스트 🛠️

1. URL 경로 확인

• 문제: URL 입력 실수 또는 경로가 꼬였을 가능성.
• 해결: 정확한 경로로 접속하고 있는지 확인. 예를 들어:
  • 잘못된 URL: http://localhost/mysite (index.php 경로 누락)
  • 올바른 URL: http://localhost/mysite/index.php
• 만약 프로젝트 폴더가 htdocs 아래에 없다면? 옮겨야죠!

 

 

2. .htaccess 파일 설정

• 문제: WordPress 같은 CMS에서 .htaccess가 없거나 설정이 깨졌을 가능성.
• 해결: 아래 코드를 복사해서 .htaccess 파일에 넣어보자구요.

  # BEGIN WordPress
  <IfModule mod_rewrite.c>
  RewriteEngine On
  RewriteBase /
  RewriteRule ^index\.php$ - [L]
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteRule . /index.php [L]
  </IfModule>
  # END WordPress

  이 파일은 htdocs 폴더나 프로젝트 폴더 내에 있어야 합니다.

 

 

3. Apache mod_rewrite 활성화

• 문제: Apache의 mod_rewrite가 비활성화되어 있는 경우.
• 해결:
  1. XAMPP 폴더의 apache/conf/httpd.conf 파일을 열기.
  2. # LoadModule rewrite_module modules/mod_rewrite.so를 찾아 #(주석)를 제거.
  3. Apache 재시작: XAMPP에서 "Stop" -> "Start".

 

 

4. Apache 포트 충돌 확인

• 문제: 기본 포트(80/443)가 이미 다른 프로그램에 점령(?)당한 경우.
• 해결:
  1. XAMPP Control Panel > Apache > Config > httpd.conf 열기.
  2. Listen 80을 다른 포트로 변경 (예: Listen 8080).
  3. 브라우저에서 URL도 바꿔야 함: http://localhost:8080.

 

 

 

 

"유효한 JSON 응답이 아닙니다" 오류 해결법 🤔

1. 퍼머링크 확인하기

• 퍼머링크를 설정했는데 작동이 이상하다면? 위 .htaccess 파일과 mod_rewrite가 잘 적용되었는지 다시 체크!

2. 테마/플러그인 문제인지 확인

• 최근 설치한 플러그인이나 테마가 원인일 가능성 있음.
• 모든 플러그인을 비활성화한 후, 하나씩 활성화해보며 문제를 찾자.

3. PHP 오류 로그 분석

• PHP 관련 문제가 의심된다면, xampp/php/logs/php_error_log 파일에서 오류 메시지를 확인!

 

 

 

표로 정리: 빠르게 확인할 수 있는 해결법 📝

문제	원인	해결 방법
404 오류	URL 경로 오타 또는 파일 누락	올바른 경로 입력 확인 (index.php 포함)
.htaccess 설정 오류	규칙 누락 또는 파일 위치 오류	.htaccess 생성 후 WordPress 규칙 적용
mod_rewrite 비활성화	Apache 설정 문제	httpd.conf에서 mod_rewrite 활성화, Apache 재시작
포트 충돌	포트 점유(80, 443 등)	Apache 포트를 다른 번호(8080 등)로 변경
JSON 응답 오류	REST API 설정 문제	퍼머링크 확인, 플러그인 비활성화, PHP 로그 확인

 

 

 

 

 

 

 

저의 의견: 에러는 내게 맡겨줘! 🙌

 이런 오류들, 처음엔 진짜 좌절하게 만든다구요. "왜 내 프로젝트만 안 돼?!"라는 마음 이해해요. 근데 사실 이건 누구에게나 발생할 수 있는 아주 흔한 문제라서 너무 걱정하지 마세요. 😅

 

 에러를 고치다 보면 결국 개발 실력이 훅훅 늘어요. 특히 XAMPP 같은 로컬 환경은 실전의 축소판이라, 여기서 해결 방법 익혀두면 나중에 서버 올릴 때 훨씬 수월합니다.

 

 그리고 JSON 응답 오류? 사실 퍼머링크랑 연관된 경우가 많더라구요. 그러니 항상 기본부터 점검해 보세요. 플러그인, 테마, .htaccess, 이 순서로요!

 

 마지막으로, 해결 안 되면 "포기하지 말고 구글링!" XAMPP 에러는 전 세계 사람들이 비슷한 경험을 겪으니, 누군가 이미 해결법을 공유했을 확률이 높아요. 우리 같이 "개발자 레벨업" 합시다! 💪