페이지는 열리는데 옆의 report.pdf 링크만 404가 나면 상대 주소가 어느 기준 URL에서 계산됐는지 보세요. /guide/a와 /guide/a/는 글자 하나 차이지만 상대 경로를 붙일 때 기준 디렉터리가 달라질 수 있습니다. 화면 제목이 같아도 브라우저가 보는 최종 주소를 확인해야 합니다.
페이지가 서버에서 다른 경로로 이동하거나 문서에 base 요소가 있으면 기준이 바뀔 수 있습니다. 경로 앞에 슬래시를 붙이면 사이트 루트에서 시작하지만, 사이트가 /docs/ 같은 하위 위치에 배포됐다면 오히려 필요한 접두사를 잃을 수 있습니다. 운영 주소와 미리보기 주소에서 따로 확인하세요.

재현 조건과 관찰 결과
두 기준 URL에서 같은 상대 참조를 해석했습니다. 브라우저와 같은 WHATWG URL 규칙을 쓰는 Node URL로 최종 경로만 계산했으며 네트워크 요청은 보내지 않았습니다. 끝 슬래시 없는 마지막 경로 구성 요소가 상대 해석에서 어떻게 취급되는지 확인할 수 있습니다.
| 확인 항목 | 관찰 결과 |
|---|---|
| 끝에 슬래시 없음 | /guide/report.pdf |
| 끝에 슬래시 있음 | /guide/a/report.pdf |
| 경로 앞에 / 사용 | /report.pdf |
같은 입력으로 다시 확인하기
new URL("report.pdf", "https://example.com/guide/a")
new URL("report.pdf", "https://example.com/guide/a/")
문서 주소가 바뀌었는지 추적
/guide/a에서 report.pdf는 /guide/report.pdf가 됩니다. /guide/a/에서 같은 문자열은 /guide/a/report.pdf가 됩니다. 첨부 문서가 /guide 안에 있고 두 URL 모두 열 수 있다면, 어떤 기준으로 링크를 계산할지 명시해야 서로 다른 곳으로 가지 않습니다.
실제 작업에서 확인할 순서
- 주소 표시줄의 최종 주소와 링크가 적은 원문을 각각 적습니다.
- 기준 주소의 끝 슬래시와 문서의 base 설정을 확인합니다.
- 현재 경로 기준, 루트 기준, 완전한 주소 중 어떤 표현이 의도에 맞는지 결정합니다.
- 페이지를 하위 경로와 끝 슬래시가 있는 주소에서 각각 열어 최종 링크가 같은 파일을 찾는지 확인합니다.
로컬 미리보기에서는 사이트 루트가 달라 실제 운영 주소와 동일한지 확인하기 어렵습니다. 배포 환경에서 최종 주소를 확인하고, 이동한 뒤의 문서에서 같은 링크를 한 번 더 확인하세요. 사이트가 하위 디렉터리로 배포된다면 /로 시작하는 경로도 그 앞부분을 유지하는지 살펴야 합니다.
주소 입력과 결과를 함께 보관
개발자 도구에서 링크의 원래 href와 브라우저가 해석한 절대 주소를 각각 확인합니다. 두 값이 다른 것이 문제가 아니라 목적지까지 포함한 결과가 의도와 맞는지 판단하세요. 요청이 실제로 404라면 이동 후 최종 응답인지 처음 주소의 응답인지도 구분합니다.
결과가 다를 때
사이트 전체 링크에 무조건 슬래시를 추가하면 기존 구조가 다른 페이지에서 새 오류가 날 수 있습니다. 처음 실패한 주소에서 기준과 결과를 재현한 뒤 같은 구조의 링크만 수정하세요.
정상 완료 기준과 적용 범위
두 주소 모두 의도한 파일을 가리키거나, 차이가 설계에 명시돼 있습니다. 아래 예제는 WHATWG URL 구현에서 문자열을 해석했으며 외부 서버로 요청하지 않았습니다.
