개발
2026.09.22 · 2분
태그를 합치기 전에 옛 주소가 어떻게 되는지 확인하려고 아무 말이나 넣어 봤다.
curl -o /dev/null -w "%{http_code}" https://블로그/tags/없는태그
200
없는 태그인데 200 이다. 코드에는 분명히 이렇게 돼 있었다.
const posts = (await getPublishedPosts()).filter((p) => p.tags.includes(tag))
if (posts.length === 0) notFound()
notFound() 는 불렸다처음엔 조건이 안 걸리는 줄 알았다. 로그를 찍어 보니 notFound() 는 정확히 불리고 있었다. 화면도 404 화면이 나온다. 상태 코드만 200 이다.
응답을 다시 보니 이런 게 들어 있었다.
<meta name="robots" content="noindex"/>
<title>#없는태그 · DevsJun</title>
noindex 가 붙어 있다. 누군가 의도적으로 이 상황을 다루고 있다는 뜻이다.
공식 문서의 Status Codes 절에 그대로 적혀 있다.
When streaming, a
200status code will be returned to signal that the request was successful.
그리고 왜 나중에 못 바꾸는지도 적혀 있다.
Because the response headers have already been sent to the client, the status code of the response cannot be updated.
상태 코드는 헤더에 들어 있다. 헤더는 본문보다 먼저 나간다. 본문이 흐르기 시작한 뒤에 notFound() 를 불러도 이미 나간 헤더를 주워 담을 수 없다.
그럼 본문은 언제부터 흐르는가.
The response body starts streaming when a Suspense fallback renders (for example, a
loading.tsx) or when a Server Component suspends under aSuspenseboundary.
loading.tsx. 그 세그먼트에 그 파일을 둔 순간 스트리밍이 켜지고 그때부터 그 아래에서 부르는 notFound() 는 상태 코드를 못 만진다.
나는 CLS 때문에 loading.tsx 를 뒀다. 스트리밍 골격이 짧으면 푸터가 화면 안에 들어왔다가 본문이 도착할 때 크게 밀리는 문제가 있어서 넣은 파일이다. 그 파일이 상태 코드까지 바꿀 줄은 몰랐다.
문서가 이 상황을 뭐라고 부르는지도 적어 뒀다.
Some crawlers may label these responses as "soft 404s". In the streaming case, this does not lead to indexation because the page is explicitly marked
noindexin the HTML.
색인 측면에서는 Next 가 막아 준다. 그건 다행이다.
다만 색인만 문제가 아니다.
마지막 항목 때문에 나는 태그를 합칠 때 308 리다이렉트를 같이 깔았다. 그냥 두면 옛 주소가 소프트 404 로 조용히 사라지면서 쌓인 평가를 버린다.
문서가 방법까지 적어 준다.
If you need a 404 status, for compliance or analytics, ensure the resource exists before the response body is streamed, so that the server can set the HTTP status code.
본문이 흐르기 전에 존재를 확인하라는 것이다. Next 16 에서는 proxy 에서 하면 된다. 다만 문서가 덧붙인 조건이 있다 — 그 검사는 빨라야 하고 거기서 콘텐츠를 통째로 가져오면 안 된다.
나는 그대로 두기로 했다. 근거는 셋이다.
noindex 가 막는다. 이 블로그에서 상태 코드로 아쉬운 건 색인뿐이었다.proxy 에 DB 조회를 넣는 건 비용이 크다.loading.tsx 를 빼면 CLS 문제가 돌아온다. 그쪽이 실제 방문자에게 더 나쁘다.상황이 다르면 답도 다르다. 중요한 건 파일 하나가 상태 코드를 바꾼다는 사실을 알고 고르는 것이다. 나는 몰라서 한동안 200 을 내고 있었다.
이 글은 AI 가 조사·초안을 작성하고 사람이 검수한 뒤 발행했습니다. 사실관계는 아래 출처에서 확인할 수 있습니다.