오늘 작두뉴스 글이 제대로 열리는지 확인하다가 한참을 엉뚱한 데서 헤맸다.
관리자 화면에는 글이 발행된 것으로 나왔다. 제목도 있고 본문도 있었다. 그런데 내가 확인하려고 연 주소에서는 404가 떴다. 처음에는 잠깐 반영이 늦는 건가 싶어서 다시 열어 봤는데 그대로였다.
이전에도 관리자 안에서는 멀쩡한데 실제 사이트에는 글이 안 보인 적이 있었다. 그래서 이번에도 자연스럽게 저장이나 공개 설정 문제라고 생각했다. 관리 화면에 자료가 존재하는 것과 방문자가 그 자료를 볼 수 있는 것은 서로 다른 일이다. 글이 저장돼 있어도 공개 상태, 주소 규칙, 접근 조건 가운데 하나가 맞지 않으면 바깥에서는 보이지 않을 수 있다.
우선 관리자에서 글 상태를 다시 확인했다. 임시 저장이 아니라 발행으로 표시돼 있었고 제목, 본문, 고유 주소도 남아 있었다. 여기까지 보고 나니 글 자체가 저장되지 않은 문제는 아니라는 생각이 들었다.
그다음에는 공개 조건을 의심했다. 작두뉴스는 관리자에게는 모든 글을 보여 주지만 일반 방문자에게는 공개 조건을 통과한 글만 보여 준다. 이런 구조에서는 관리자 화면에서 잘 열리는 것만 보고 발행이 끝났다고 판단하면 안 된다. 로그아웃한 상태의 실제 주소도 따로 확인해야 한다.
문제는 이때 이미 내 머릿속에서 ‘발행된 기사가 사이트에서 사라졌다’는 결론이 나 있었다는 점이다. 그러니 이후에 보는 것도 전부 서버, 저장 상태, 공개 조건 쪽이었다. 주소가 틀렸을 가능성은 생각하지 않았다.
404는 서버가 완전히 고장 났다는 뜻이 아니다. 브라우저가 요청한 주소에 보여 줄 페이지를 찾지 못했다는 뜻에 가깝다. 글이 실제로 없어도 404가 나오고, 글은 있는데 주소를 잘못 입력해도 똑같은 화면이 나온다. 당시에는 이 단순한 차이를 놓치고 있었다.
나중에 주소창을 한 부분씩 다시 보다가 그제야 이상한 단어를 발견했다. 내가 기사 주소에 news를 넣고 있었다. 작두뉴스니까 기사 주소도 당연히 news일 거라고 머릿속으로 주소를 만들어 낸 것이다.
실제 기사 주소는 news가 아니라 blog였다.
사이트 주소 뒤에 붙는 blog 같은 부분을 경로라고 한다. 작두뉴스에서는 /blog/다음에 각 글의 고유 이름이 붙는다. 이 고유 이름은 보통 슬러그라고 부른다. 제목이 같은 글이 있더라도 슬러그가 다르면 서로 다른 주소로 구분할 수 있다.
내가 열었던 주소는 경로부터 틀려 있었다. 뒤의 슬러그가 아무리 정확해도 앞부분을 /news/로 쓰면 사이트는 해당 페이지를 찾지 못한다. /news/와 /blog/는 사람 눈에는 비슷한 기사 주소처럼 보여도 서버에는 전혀 다른 위치다.
주소에서 news를 blog로 바꾸자 글이 바로 열렸다. 아까까지 사라졌다고 생각했던 제목과 본문이 그대로 나왔다. 서버 문제도 아니었고 발행이 실패한 것도 아니었다. 내가 존재하지 않는 경로를 계속 열고 있었다.
카테고리 주소도 내가 생각한 방식과 달랐다. 작두뉴스에서는 카테고리 이름이 기사 주소 중간에 들어가지 않는다. 첫 화면 주소 뒤에 물음표와 category 값을 붙여 목록을 거른다. 이런 물음표 뒤의 값은 쿼리 매개변수라고 한다.
경로와 쿼리 매개변수는 역할이 다르다. /blog/글이름은 특정 글을 찾아가는 주소이고, ?category=making 같은 값은 첫 화면에서 특정 분류만 골라 보는 조건이다. 나는 둘을 정확히 구분하지 않은 채 카테고리 이름까지 기사 주소에 들어갈 것이라고 생각했다.
올바른 주소로 글이 열린 뒤에는 다른 글도 몇 개 더 확인했다. 첫 화면에서 제목을 직접 눌러 나온 주소와 내가 손으로 입력했던 주소를 나란히 비교했다. 전부 /blog/ 경로를 사용하고 있었다. 그제야 기사가 사라진 게 아니라 처음부터 내가 다른 곳을 보고 있었다는 게 확실해졌다.
이번 일을 겪고 404가 나올 때 확인하는 순서도 바꿨다. 먼저 첫 화면이나 관리자 화면에서 링크를 직접 눌러 본다. 그다음 주소의 도메인, 경로, 슬러그 순서로 오타가 없는지 본다. 주소가 정확한데도 열리지 않을 때 공개 상태와 접근 조건을 확인한다. 서버나 배포 문제는 그다음이다.
이 순서가 중요한 이유는 앞쪽 확인일수록 빠르고 안전하기 때문이다. 주소 오타를 찾는 데는 설정을 바꿀 필요가 없다. 반대로 원인을 확인하기 전에 공개 조건이나 코드를 수정하면 멀쩡한 부분까지 바뀔 수 있다.
나도 주소를 바로잡기 전에는 공개 조건을 다시 손봐야 하나 생각했다. 그 상태에서 코드를 수정했다면 실제 문제는 그대로인데 다른 기능까지 달라졌을 것이다. 아무 설정도 바꾸기 전에 주소를 발견한 것이 다행이었다.
확인 횟수가 많다고 반드시 꼼꼼한 것도 아니었다. 나는 같은 주소를 여러 번 열었고 매번 똑같은 404를 봤다. 하지만 잘못된 주소를 열 번 확인해도 올바른 결과가 나오지는 않는다. 무엇을 기준으로 확인하는지가 횟수보다 먼저였다.
솔직히 이런 실수는 기록하지 않고 넘어가고 싶었다. 고친 일만 보면 news를 blog로 바꾼 것이 전부라서다. 그래도 사이트를 직접 관리하면서 실제로 시간을 잡아먹은 것은 이런 작은 착각이었다. 완성된 기능 설명보다 실패한 확인 과정을 남기는 편이 비슷한 문제를 겪는 사람에게는 더 도움이 될 수 있겠다고 생각했다.
지금은 관리자에서 글을 찾은 뒤 슬러그를 눈으로 옮겨 적지 않고 실제 링크를 눌러 주소를 확인한다. 주소를 공유해야 할 때도 열린 페이지의 주소를 그대로 복사한다. 아주 단순한 습관이지만 사람이 머릿속으로 경로를 조합하면서 생기는 실수를 줄여 준다.
오늘 확인한 내용은 간단하다. 관리자에 글이 있다는 사실, 공개 주소가 정확하다는 사실, 방문자가 접근할 수 있다는 사실은 각각 따로 확인해야 한다. 그리고 404가 떴을 때는 서버부터 의심하기 전에 내가 요청한 주소가 정말 맞는지 먼저 봐야 한다.
작두뉴스 기사 주소는 news가 아니라 blog다. 이 한 단어를 늦게 확인해서 없는 문제를 한참 붙잡았다. 다음에 같은 화면을 만나면 적어도 이번보다는 빨리 주소창을 볼 것 같다.
글쓴이: 작두뉴스 운영자
기록일: 2026년 8월 26일
댓글 0