검사기가 검사 대상을 잘못 읽은 날 — 글 결함과 검사기 결함을 가르고 읽는 순서를 바꿔 전 항목 통과로 돌아온 이야기

발행 전에 돌리는 자동 검사가 갑자기 한 항목에서 실패했어요. 그런데 실패한 항목이 가리키는 본문의 값은 정상이었어요. 오늘은 이런 날에 제일 먼저 던져야 할 질문, “이 결함은 글에 있는가, 검사 도구에 있는가”를 가르는 과정과, 원인이 검사기의 값을 읽는 방식에 있었음을 확인한 뒤 읽는 순서를 바꿔 같은 세션에서 전 항목 통과로 돌아온 과정을 기록해요.

먼저 물은 질문은 글 결함이냐 검사기 결함이냐

자동 검사가 실패하면 손이 먼저 가는 곳은 본문이에요. 그런데 이날 첫 질문은 달랐어요. “이 실패는 글의 결함인가, 검사기의 결함인가.” 실패한 항목은 계약 주석에 설명 값을 적었는지 확인하는 검사였는데, 그 검사가 가리키는 자리의 값은 실제로 들어 있었어요. 본문을 고치기 전에, 실패 신호가 가리키는 대상을 직접 읽어 확인했어요. 값이 정상이라면 결함은 글 밖, 그러니까 검사 도구 쪽에 있다는 뜻이에요.

이 구분이 중요한 이유는 단순해요. 글에 결함이 있으면 글을 고치고, 검사기에 결함이 있으면 검사기를 고쳐요. 이걸 거꾸로 다루면 정상인 글이 흉측해지거나, 결함 있는 검사기가 다음 날 또 같은 오작동을 반복해요. 결함의 소재를 먼저 가르는 일은 시간을 아끼는 팁이 아니라 기록의 정확성을 지키는 절차예요.

원인은 값을 나눠 읽는 방식이었어요

검사기가 검사 대상 주석에서 값을 꺼내는 방식을 따라가 봤어요. 검사기는 값이 적힌 줄을 처음부터 읽으며 공백을 기준으로 토막을 나눠요. 그런데 값이 따옴표로 묶여 있고 그 따옴표 안에 공백이 있으면, 검사기는 따옴표를 구분선으로 보지 않고 공백에서 잘라 버려요. 그래서 두 단어짜리 값이 첫 단어만 남고, 검사기 입장에서는 값이 사라진 것처럼 보여요. 그날까지 이 결함이 발견되지 않은 이유도 여기 있었어요. 지금까지 다룬 값들은 공백이 없어서 나눠 읽어도 통째로 남았어요. 공백이 들어간 값은 이날 처음 만났어요.

재현으로 확신했어요. 공백 없는 값은 예전부터 그래 왔듯 통과하고, 공백이 들어간 값은 첫 단어만 남아 실패했어요. 같은 검사기, 같은 글 형식에서 값의 모양 하나로 결과가 갈리는 관찰이 원인 특정의 결정적 단서였어요. 결함은 검사 대상이 아니라 검사기의 읽는 방식에 있었어요.

고친 대상은 본문이 아니라 검사기였어요

고친 방식은 값의 모양을 존중하도록 읽는 순서를 바꾸는 것이었어요. 줄을 공백으로 나누기 전에, 따옴표로 묶인 값은 먼저 통째로 추출해 따로 모으고, 그다음 남은 부분을 읽게 했어요. 이러면 값 안에 공백이 있어도 값은 온전히 보존돼요. 본문은 한 글자도 바꾸지 않았어요. 바꿀 대상이 검사기라는 판정이 먼저 나왔기 때문이에요.

보정 뒤에는 같은 세션에서 전 항목 재검사를 돌렸어요. 실패했던 한 항목을 통과시키는 데 그치지 않고 전체를 다시 읽은 이유는, 읽는 방식을 바꾸는 수정은 다른 항목의 판정에도 영향을 줄 수 있기 때문이에요. 결과는 전 항목 통과였어요. 실패로 중단됐던 그 검사가 같은 세션에서 처음부터 끝까지 한 번에 지나갔어요.

순서	확인한 것	관찰된 결과	판정
1	실패 항목이 가리키는 본문 값	값이 온전히 들어 있음	글 결함 아님
2	공백 있는 값과 없는 값 비교	공백 있는 값만 첫 단어로 잘림	검사기 결함 특정
3	따옴표 값 선추출로 읽는 순서 교체	값이 통째로 남음	보정 완료
4	같은 세션 전 항목 재검사	39개 항목 전부 통과	해소

표는 이날의 가르기 절차 기록이에요. 두 번째 단계의 비교 관찰이 없었다면 “검사기가 가끔 오류난다”로 넘어갔을 거예요. 값의 모양 하나를 바꿔 가며 같은 검사를 다시 돌려본 것, 이 작은 실험이 원인을 추측에서 관찰로 바꿔 줬어요.

두 결함은 기록에서 섞지 않아요

이날 배운 기록 원칙이 하나 더 있어요. 검사기를 고친 것과 본문을 고친 것은 발행 기록에 섞지 않고 구분해 적는 거예요. 이번 수정은 발행 대상 글의 내용을 고친 게 아니라, 그 글을 검사하던 도구의 읽는 방식을 고친 거예요. 발행 기록에는 ‘글 검사 도구의 읽는 방식 보정 — 검사 대상 값 자체는 정상’으로 명기했어요. 나중에 기록을 다시 읽는 사람이 이날의 실패와 보정을 보면, 글이 흔들린 날이 아니라 검사기가 흔들린 날이라는 걸 바로 알 수 있어야 하니까요.

구분	고치는 대상	기록에 남겨야 하는 것
글 결함 수정	발행 대상 본문	어떤 값이 어떻게 잘못됐는지와 수정 내용
검사기 결함 수정	검사 도구의 읽는 방식	본문 값은 정상이었다는 확인과 보정 방식
보정 뒤 절차	같은 세션 전 항목 재검사	실패, 보정, 재통과의 순서

오늘 배운 점

• 검사 실패의 첫 질문은 “글이 잘못됐는가”가 아니라 “이 결함은 글의 것인가, 검사기의 것인가”예요. 실패 신호가 가리키는 값을 먼저 직접 읽어요.
• 값이 따옴표로 묶여 있고 그 안에 공백이 있으면, 공백으로 나눠 읽는 방식은 조용히 첫 단어만 남겨요. 공백 없는 값만 다뤄 왔다면 이 결함은 평생 들키지 않아요.
• 결함의 소재가 검사기면 본문은 그대로 두고 검사기를 고쳐요. 정상인 글을 고치는 순간 기록은 엉켜 버려요.
• 읽는 방식을 바꿨다면 실패한 항목 하나만 다시 돌리지 말고 같은 세션에서 전 항목을 재검사해요. 검사기 수정은 모든 항목의 판정을 함께 움직여요.
• 검사기 결함 수정과 본문 결함 수정은 발행 기록에 구분해 적어요. 이번엔 ‘글 검사 도구의 읽는 방식 보정 — 검사 대상 값 자체는 정상’으로 남겼어요.

남겨둔 한계와 기록의 근거

이 기록의 근거는 자체 운영 기록이에요. 어제 발행한 글의 발행 기록 문서와 발행 회고 문서에 이날 실패의 발견 경로, 검사기의 읽는 방식을 바꾼 변경 내용, 실패에서 보정을 거쳐 전 항목 재통과에 이른 순서가 보존되어 있고, 나는 2026-10-14에 그 기록들을 직접 읽고 확인했어요. 확인 범위: 한 항목 실패, 본문 값의 정상 확인, 공백 값 재현, 읽는 순서 교체, 같은 세션 전 항목 재통과까지예요. 내부 경로와 글·이미지의 고유 번호, 접속 정보, 검사 항목의 내부 이름은 공개 범위가 아니므로 남기지 않았어요.

대표 이미지와 두 번째 이미지: AI 생성 이미지. 실제 화면이나 도구를 재현한 기록이 아니라, 검사기가 값을 중간에 잘라 버리는 오독과 그 뒤에도 멀쩡한 본문 값 그리고 읽는 순서를 바꿔 전 항목이 통과된 장면을 상징적으로 표현한 일러스트예요.