멀티테넌트 PHP 플랫폼의 canonical·소프트 404 버그 4종
## 개요
도메인 수백 개를 한 코드베이스로 서비스하는 플랫폼에서 검색 노출에 직접 영향을 준 canonical·404 버그 네 가지를 고친 기록이다.
## 1. 내부용 도메인명이 공개 주소로 노출
로그인 페이지가 공개용 `canonical_domain` 대신 내부 식별용 `domain_name`(`.local`)을 canonical 에 썼다. 104개 도메인에 영향이 있었고 검색에 관리자 로그인 페이지가 노출됐다. 컬럼의 **용도(내부용/공개용)** 를 구분해 공개 값을 쓰도록 고쳤다.
## 2. 빈 문자열은 NULL 이 아니다
`canonical_url` 에 NULL 이 아니라 **빈 문자열**이 들어 있어 `??` 폴백이 동작하지 않았다. `?? ` 는 NULL 만 걸러 낸다. 빈 문자열까지 걸러야 하면 `!empty()` 또는 `?:` 를 쓴다. 존재하지 않는 도메인이 canonical 로 지정된 건도 함께 정리했다.
## 3. 쿼리스트링이 사라지는 canonical
`parse_url($url, PHP_URL_PATH)` 는 쿼리스트링을 제거한다. 게시판 상세(`?id=`)의 canonical 이 목록이나 홈으로 **수렴**했다. 38개 테마의 헤드 파일에서 경로 변수를 `$path` 에서 쿼리 포함 `$uri` 로 바꿔 해결했다.
## 4. 라우터 기본값이 만든 소프트 404
라우터의 `$templateFile` 기본값이 `'index.php'` 라서 **임의의 URL이 전부 홈을 200 으로 반환**하고 canonical 도 자기 자신이 됐다. 기본값을 `null` 로 바꾸고 체인 끝에서 진짜 404 를 내도록 수정했다.
## 점검 방법
- 임의의 경로(`/없는-페이지-12345`)가 404 를 반환하는지 도메인별로 확인한다.
- 게시판 상세 URL 의 canonical 이 요청 URL(쿼리 포함)과 일치하는지 샘플링한다.
- 응답 본문의 `link rel=canonical` 호스트가 공개 도메인인지 정규식으로 전수 검사한다.
이전글
PHP 7.4 → 8.5 마이그레이션 실전 — DB 래퍼·복제 지연·엑셀 라이브러리
다음글
BaaS 에서 AWS 자체 인프라로 DB 이관 — FK 순서·스키마 드리프트·사설망
게시글 목록
| 제목 | 작성일 | 조회 |
|---|---|---|
| 자체 개발 웹 엔진 nginx-drsoft로 수백 개 도메인 무중단 운영하기 | 265 | |
| Redis Cluster를 활용한 멀티테넌트 환경 세션 관리 시스템 구축 사례 | 84 |