# WordPress 퍼머링크 및 404 오류 문제 해결

Source: https://support.kapsulehost.com/ko-kr/wordpress-permalink-issues

WordPress 페이지가 존재해야 하는데 404 오류를 반환하거나 마이그레이션 또는 플러그인 변경 후 사이트 내 링크가 손상된 경우, 가장 일반적인 해결 방법은 WordPress 재쓰기 규칙을 플러시(재생성)하는 것입니다.

### 빠른 해결: 퍼머링크 플러시

1. `yourdomain.com/wp-admin`에서 WordPress 관리자에 로그인합니다
2. **설정 > 퍼머링크**로 이동합니다
3. 아무것도 변경하지 않고 **변경사항 저장**을 클릭합니다

이 작업은 `.htaccess` 파일을 재생성하고 재쓰기 규칙을 플러시합니다. 대부분의 경우 이 작업을 수행한 직후에 404 오류가 해결됩니다.

### WordPress 관리자에 접근할 수 없는 경우

404 문제로 인해 로그인하거나 관리자에 접근할 수 없는 경우:

1. SFTP를 통해 사이트에 연결합니다. [SFTP 접근](https://support.kapsulehost.com/ko-kr/sftp-access)을 참조하세요
2. WordPress 설치의 루트로 이동합니다
3. `.htaccess` 파일을 엽니다 ([KapsuleHost에서 .htaccess 이해](https://support.kapsulehost.com/ko-kr/wordpress-htaccess) 참조)
4. WordPress 주석 마커 사이의 내용을 기본 WordPress 규칙으로 바꿉니다:

```
# 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
```

5. 파일을 저장합니다
6. WordPress 관리자에 로그인하고 위와 같이 퍼머링크를 다시 저장합니다

> **Warning:** `.htaccess` 규칙은 `# BEGIN WordPress`와 `# END WordPress` 마커 사이의 것만 수정합니다. 이 마커 외부의 모든 항목은 다른 플러그인이나 서버 구성에서 추가된 것이므로 제거하면 안 됩니다.

### 마이그레이션 후 퍼머링크 설정

[사이트를 KapsuleHost로 마이그레이션](https://support.kapsulehost.com/ko-kr/migrating-to-kapsule)한 경우, 기존 `.htaccess` 파일에 다른 서버 환경의 규칙이 포함되어 있을 수 있습니다. 마이그레이션 후:

1. **설정 > 퍼머링크**로 이동합니다
2. 원하는 URL 구조를 선택합니다 (예: **게시물 이름**)
3. **변경사항 저장**을 클릭합니다

> **Tip:** 사용자 정의 퍼머링크 구조를 사용하는 경우 플러시하기 전에 기록해 두세요. 플러시는 선택한 퍼머링크 형식을 변경하지 않으며, 단지 작동하게 하는 규칙을 재생성할 뿐입니다.

### 문제가 계속되는 경우

다음을 확인하세요:

- `mod_rewrite`이 서버에서 활성화되어 있는지 확인합니다 (KapsuleHost는 기본적으로 이를 활성화합니다)
- 사이트 루트의 `.htaccess` 파일이 웹 서버에서 쓰기 가능한지 확인합니다
- 최근에 설치한 플러그인을 한 번에 하나씩 비활성화하여 충돌을 확인합니다

이 중 어느 것도 문제를 해결하지 못하면 KPanel의 **지원** 아래에서 지원 티켓을 엽니다.