fetch 가 403 을 성공으로 넘겨 저장한 표시가 되돌아올 때

먼저 결론
증상: 관리 화면에서 확인 표시를 눌러 저장했는데 새로고침하면 되돌아왔고, 오류 알림도 없었습니다.
원인: 저장 함수가 fetch(...).then(r => r.json()) 라 HTTP 상태를 안 봤습니다. fetch 는 403 에도 reject 하지 않아, 서버의 거부가 성공으로 통과했습니다.
해결: r.ok 를 먼저 보고, 성공은 서버가 ok: true 라고 말했을 때만 인정하며, 저장은 바뀐 것만 보냅니다.

운영 중인 관리 화면에는 항목마다 "확인했다"는 표시를 누르는 칸이 있었습니다. 누르면 화면에는 표시가 들어가는데, 새로고침하면 다시 빠져 있었습니다. 화면에는 아무 오류도 뜨지 않았습니다.

이 글은 그 원인을 찾아간 순서대로 적은 것입니다. 원인은 하나가 아니라 세 가지 습관이 한자리에서 겹친 것이었습니다.

첫 번째 사건: 눌러도 저장이 안 됐다

저장 함수는 이렇게 생겼습니다.

function apiPost(body) {
  return fetch('/api/marks', { method: 'POST', body: JSON.stringify(body) })
    .then(r => r.json())
}

apiPost(change).then(res => {
  if (res.ok === false) { alert('저장 실패') }
})

서버는 csrf 토큰이 맞지 않아 403 을 돌려주고 있었습니다. 본문은 {"err":"csrf"} 였고 ok 칸이 아예 없었습니다. 그러니 res.ok 는 undefined 이고, undefined === false 는 거짓이라 실패 검사에 걸리지 않았습니다.

여기에 fetch 의 성질이 더해집니다. fetch 는 네트워크가 끊겼을 때만 reject 하고, 403 이나 500 은 정상 응답으로 돌려줍니다. 상태 코드를 직접 보지 않으면 거부와 성공이 구별되지 않습니다. 그 결과 저장 대기열은 비워지고, 알림은 안 뜨고, 서버에는 안 남고, 새로고침 때 표시가 되돌아왔습니다.

두 번째 사건: 하나를 눌렀더니 117개가 사라졌다

다른 때에는 더 큰 일이 났습니다. 서버에는 확인 표시가 121개 있었는데, 하나를 누른 순간 117개가 사라졌습니다. "전에 눌렀던 것도 다시 떠 있다"는 말로 발견됐습니다.

저장이 바뀐 것만 보내는 방식이 아니라, 화면이 아는 목록 전체로 서버를 덮어쓰는 방식이었기 때문입니다.

{ "op": "set", "keys": [ 화면이 아는 표시 전부 ] }

그때 화면은 낡은 상태라 표시를 3개만 알고 있었습니다. 하나를 누르니 keys 에 4개만 실려 나갔고, 서버는 그 4개로 121개를 갈아 끼웠습니다. 캐시, 자동 갱신 전의 순간, 오래 켜 둔 탭은 모두 화면을 낡게 만듭니다. 누를수록 과거가 지워지는 구조였습니다.

세 습관이 겹친 자리

습관 혼자일 때 겹쳤을 때
HTTP 상태를 안 봄 거부가 성공으로 보임 저장 실패를 아무도 모름
"거부가 아니면 성공"으로 판정 응답 모양이 바뀌면 샘 ok 칸 없는 403 이 통과
전체 덮어쓰기 저장 낡은 화면이 기록을 되돌림 121개 중 117개 삭제
.catch(() => {}) 실패가 조용히 사라짐 되돌아감이 영구가 됨

네 번째 줄은 덤으로 붙은 것입니다. 저장 실패를 빈 catch 가 삼켜서, 실패하면 다음 갱신 때 그대로 되돌아갔습니다. 파이썬에서 같은 모양으로 실패가 숨는 경우는 파이썬에서 실패가 조용히 숨는 경우에 정리했습니다.

고친 것과 그 뒤로 지키는 규칙

  1. 상태 코드를 먼저 본다. r.ok(2xx)가 아니면 실패로 처리합니다.
  2. 성공은 성공이라 말했을 때만. 판정을 ok === false 가 아니라 ok !== true 로 바꿨습니다.
  3. 토큰 거부는 한 번 자동 재시도. 403 이면 토큰을 새로 받아 한 번 더 보냅니다. 사용자가 손댈 일이 아닙니다.
  4. 바뀐 것만 보낸다. add, remove 로 나눠 보내고, 기준은 늘 서버입니다. 응답 전의 로컬 변경은 따로 기억해 두었다가, 자동 갱신이 목록을 갈아 끼운 뒤에 다시 얹습니다.
  5. 위험한 요청은 서버가 막게 한다. 전체 덮어쓰기나 일괄 삭제 같은 요청은 서버가 거부해야 한다는 것을 그 뒤 규칙으로 두었습니다. 낡은 탭은 화면 코드를 고쳐도 옛 코드로 계속 돌기 때문입니다.
async function apiPost(body, retried = false) {
  const r = await fetch('/api/marks', {
    method: 'POST',
    headers: {
      'content-type': 'application/json',
      'x-csrf-token': getToken(),   // 부를 때마다 지금 토큰을 읽는다
    },
    body: JSON.stringify(body),
  })
  if (r.status === 403 && !retried) {
    await refreshToken()
    return apiPost(body, true)
  }
  const res = await r.json().catch(() => ({}))
  if (!r.ok || res.ok !== true) throw new Error('save failed: ' + r.status)
  return res
}

apiPost({ op: 'add', keys: ['항목-17'] })

토큰을 머리에 싣는 줄이 요점입니다. refreshToken() 이 새 토큰을 저장해 두면, 다시 부른 apiPost 가 getToken() 으로 그 새 값을 읽어 보냅니다. 토큰을 함수 밖에서 한 번만 읽어 두면 재시도도 옛 토큰을 실어 같은 403 을 받습니다. 머리 이름(x-csrf-token)은 서버마다 다르니 자기 서버가 읽는 이름으로 바꿉니다.

실패 경로에는 서버 기록 한 줄도 남기게 했습니다. 이번에는 접근 기록을 꺼 두어서 같은 일이 몇 번이나 있었는지 끝내 세지 못했습니다.

고쳤다는 증명은 이렇게 한다

그 뒤로는 이렇게 합니다. 같은 저장 코드가 화면 여러 곳에 복제되어 있으면 결함도 같이 복제된 것이니, 고치기 전에 전부 grep 으로 찾아 한꺼번에 바꿉니다.

시험도 고친 코드에서만 돌리지 않습니다. 고치기 전 코드로 같은 시험을 돌려 FAIL 이 나는지 먼저 봅니다. 그래야 시험이 정말 이 결함을 보고 있다는 증거가 됩니다. 검사는 통과했는데 실제 서버는 깨져 있던 경우는 py_compile 검사를 통과했는데 라이브 서버가 죽었을 때에 따로 적었습니다. 화면이 실패를 "정상"으로 그리는 비슷한 문제는 감시 화면은 초록인데 뒤에서는 멈춰 있을 때에 이어서 적었습니다.

확인한 환경

항목 내용
화면 브라우저에서 도는 관리 화면, 저장은 fetch POST
서버 거부 403, 본문 {"err":"csrf"}
기록한 때 2026년 7월

이 글의 내용은 2026년 10월 25일에 마지막으로 확인했습니다. 틀린 곳을 발견하시면 연락처로 알려 주세요.