RSS 피드에 관리자 페이지를 붙일 때

처음 RSS를 구현했을 때 로컬에서는 잘 보였는데 배포 후 메타 정보가 누락되거나 feed 구조가 깨지는 경험을 했다. 이 과정에서 배운 게 많다.

Next.js에서 RSS를 다룰 때는 빌드 과정이 중요하다. 정적 생성 과정에서 메타데이터가 제대로 추출되지 않으면 아무리 응답을 봐도 원인을 못 찾는다.

빌드부터 확인하자

RSS 관련 코드를 수정했다면 먼저 빌드 로그를 자세히 봐야 한다. 경고나 에러가 있는데 무시하고 배포하면 runtime에 문제가 터진다.

• 빌드 로그 확인
• 정상 상태와의 비교
• 변경사항 기록

응답 구조 검증하기

실제 URL에서 응답이 어떻게 오는지 확인하면 메타 정보 누락을 빠르게 찾을 수 있다.

curl -s https://example.com | grep -Ei 'title|description|canonical|og:|twitter:'
npm run build

이 명령어로 크롤러가 볼 메타데이터를 직접 확인할 수 있다.

Canonical 확인의 중요성

canonical 태그가 제대로 설정되지 않으면 검색 엔진이 중복 컨텐츠로 판단할 수 있다. RSS 피드도 마찬가지다. 빌드 후 응답을 보면서 이 부분이 맞는지 체크하는 게 시간 절약이다.

1. 같은 조건에서 문제가 반복되는지 확인
2. 로그와 응답의 차이점 정리
3. 공개 환경에서 최종 테스트

작은 확인을 남겨두면 다음 문제 해결이 훨씬 빨라진다.