Codex App Server에서 스킬 파일을 고쳤는데 목록이 그대로라면, skills/list가 캐시를 재사용하는지 확인할 수 있다. 공식 문서는 이 요청이 작업 폴더별 캐시를 재사용할 수 있으며, 디스크에서 다시 읽으려면 forceReload: true를 쓰라고 설명한다.[1]

변경 알림은 새 목록이 아니다

App Server는 감시하는 로컬 스킬 파일이 바뀌면 skills/changed 알림을 보낸다. 문서는 이를 캐시 무효화 신호로 취급하고 필요할 때 현재 매개변수로 skills/list를 다시 실행하라고 안내한다.[1] 스킬 선택기를 만드는 쪽에서는 알림 수신과 목록 재조회를 따로 기록할 수 있다.

조회 범위를 유지한 채 디스크에서 다시 읽기

다음은 문서의 요청에서 한 프로젝트만 남긴 예다. cwds에 조회할 작업 폴더를 지정하고 forceReload를 참으로 둔다. 경로는 공개 문서의 예시이며 실제 프로젝트 위치로 바꿔야 한다.[1]

{
  "method": "skills/list",
  "id": 25,
  "params": {
    "cwds": ["/Users/me/project"],
    "forceReload": true
  }
}

캐시가 작업 폴더별이라는 조건도 중요하다. 다른 프로젝트 범위로 조회한 결과를 보고 수정이 반영되지 않았다고 판단하면, 갱신 여부와 조회 범위가 섞인다. 확인할 때는 어떤 cwds로 목록을 요청했는지도 함께 보자. 이는 문서의 범위·캐시 규칙에서 나온 점검 제안이다.

위 코드는 공개 문서의 형식을 설명하는 예이며 실제 서버 호출이나 파일 변경 전후 비교를 실행한 결과는 아니다. 변경 알림 수신, 지정 범위의 목록 재조회, 화면 반영을 차례로 기록하면 어느 단계가 아직 확인되지 않았는지 구분할 수 있다. 목록을 새로 읽었다는 사실만으로 진행 중인 모델 실행의 스킬 본문까지 바뀌었다고 주장하지 않는다.

참고 문서

[1] Codex App Server — Skills

2026/11/22 10:37 2026/11/22 10:37

IntersectionObserver로 스크롤 목차를 만들 때, 콜백의 마지막 항목이 지금 읽는 절이라는 보장은 없다. 이 API는 요소의 교차 상태 변화를 알려 준다. 목차에서 어느 절을 현재 위치로 표시할지는 따로 정해야 한다. 고정 헤더 아래에 읽기 기준선을 두고 그 선을 지난 마지막 제목을 고르는 방법을 검토해 보자.

현재 절을 고르는 규칙부터 정하기

아래는 구현 결과가 아닌 설계 예다. 본문은 위에서 아래로 읽고 제목도 그 순서로 배치돼 있다고 가정한다. 고정 헤더에 가리지 않는 위치에 기준선을 둔다. 문서 순서대로 제목을 살펴보며 그 선에 닿았거나 선보다 위로 올라간 제목 중 마지막 것을 현재 절로 선택한다. 아직 아무 제목도 선을 지나지 않았다면 첫 절을 표시하는 정책으로 정한다.

같은 화면에서도 목차의 선택은 읽기 규칙에 달려 있다
가정한 화면 상태기준선 규칙의 선택알림만으로 정해지지 않는 것
A절 제목은 기준선 위, B절 제목은 기준선 아래에 있다.A절B절이 화면에 들어왔다는 사실만으로 현재 절을 B로 바꿀지
B절 제목이 기준선에 닿았다.B절화면 진입과 읽기 위치 전환을 같은 시점으로 볼지
위로 돌아가 B절 제목이 기준선 아래로 내려왔다. A절 제목은 위에 있다.A절마지막으로 받은 항목 대신 현재 배치에서 무엇을 고를지

여기서는 화면에 조금 보이는 다음 절보다 기준선을 지난 절을 우선한다. 화면 중앙에 가장 가까운 제목을 고르거나 가장 넓게 보이는 절을 고르는 방식도 가능하다. 어느 규칙이든 ‘현재 절’의 의미가 달라진다. 먼저 원하는 표시를 정해야 콜백이 돌아왔다는 사실과 목차가 맞게 골랐다는 사실을 나눠 확인할 수 있다.

알림의 시간순과 제목의 문서 순서

MDN에 따르면 콜백은 임계값을 넘은 사건마다 항목을 받으며, 여러 대상의 항목이 한꺼번에 올 수 있다. 같은 대상이 짧은 시간에 여러 임계값을 넘은 항목도 함께 받을 수 있다. 항목은 발생 시간에 따라 큐로 전달되고, 정확히 시간순으로 다루려면 IntersectionObserverEntry.time을 쓰는 편이 좋다고 설명한다.[1] 여기서 순서는 사건의 시간순이다. 문서에서 제목이 놓인 순서나 독자가 읽는 순서와 같은 뜻은 아니다.

time으로 항목을 정렬해도 읽기 규칙은 생기지 않는다. 가장 최근에 교차 상태가 바뀐 요소를 알 수 있을 뿐이다. MDN은 각 항목이 특정 순간의 정보를 담으며 스크롤 방향처럼 시간에 걸친 정보가 필요하면 이전 항목을 보관해 직접 계산할 수 있다고 설명한다.[1] 또한 모든 미세한 위치 변화를 알리는 대신 설정한 임계값을 넘을 때 통지한다. 기준선으로 현재 절을 고르고 싶다면 제목이 그 선을 지나는 변화를 필요한 때 감지하는지도 별도로 확인해야 한다.

예를 들어 ‘화면에 보이는 제목만 후보로 둔다’고 바꾸면 긴 절을 읽는 동안 제목이 화면 밖으로 사라졌을 때의 정책이 필요해진다. 위 기준선 방식은 그 절의 제목이 이미 위로 지나갔어도 다음 제목이 선에 닿기 전까지 현재 절로 남긴다. 이는 IntersectionObserver가 자동으로 보장하는 동작이 아니라 이 글에서 택한 선택 규칙이다.

강조 표시와 링크 동작을 나눠 확인하기

현재 절을 정했다면 목차의 시각적 강조와 aria-current="location"이 같은 링크를 가리키도록 맞출 수 있다. MDN은 관련 요소 집합 안에서 현재 항목 하나만 aria-current로 표시하라고 설명한다.[2] 데스크톱 목차와 모바일 목차가 독립된 집합이라면 각 목차 안에서 하나씩 확인한다. 문서 전체에서 무조건 하나만 남기라는 뜻으로 확대하지 않는다.

목차 링크는 해당 제목을 가리키는 보통의 href="#..." 링크로 두고, 스크롤에 따라 강조를 갱신하는 일과 링크를 눌러 이동하는 일을 나눠 검토하는 편이 좋다. 강조를 바꾸기 위해 매번 URL을 덮어쓰는 설계를 택한다면 뒤로 가기와 기존 앵커 주소가 어떻게 달라지는지도 확인할 항목이 된다. 색이 맞게 바뀌는 장면 하나로 탐색 동작까지 통과시키지 않는다.

검증 장면은 선택한 규칙에서 나온다. 아래로 읽기와 위로 돌아가기, 앵커로 중간 절 열기, 마지막 절이 짧아 제목이 기준선까지 올라오지 못하는 경우를 살펴볼 수 있다. 마지막 경우는 본문 끝에 도착하면 마지막 절을 표시할지 별도 정책이 필요하다. 고정 헤더 높이가 달라지거나 이미지가 늦게 나타나 제목 위치가 바뀌는 상황도 확인 대상이다.

이 글은 공개 문서를 근거로 한 목차 설계 해설이다. 특정 사이트의 오류를 재현하거나 수정 효과를 측정한 결과는 아니다. 구현을 검토할 때 먼저 적어 볼 것은 ‘어떤 콜백을 쓸까’보다 ‘이 화면에서는 어느 절이 선택돼야 할까’다. 위 표의 기대 선택을 실제 화면과 대조하면 알림 수신과 읽기 위치 판정을 따로 점검할 수 있다.

참고 문서

[1] MDN — Intersection Observer API
[2] MDN — aria-current

2026/11/21 10:31 2026/11/21 10:31

PyYAML의 safe_load가 YAML을 읽는 데 성공해도 description이 문자열이라는 보장은 없다. 이 예제에서는 같은 설명을 따옴표로 감싸면 str이 됐지만, 다음 줄에 들여쓴 입력은 dict가 됐다. 문자열을 받는 프로그램이라면 파싱 성공 뒤에 값의 타입도 따로 검사해야 한다.

가상의 스킬 이름 log-reader와 설명 Read logs: keep timestamps로 이 차이를 확인했다. Python 3.11.18과 PyYAML 6.0.3의 safe_load에 작은 YAML 본문을 넣고, 파싱 성공 여부와 description 값의 타입을 확인했다. 여기서 프로그램이 요구한다고 정한 형식은 ‘description은 문자열’이다.

name: log-reader
description: "Read logs: keep timestamps"

설명 전체를 따옴표로 감싼 입력은 성공했다. description의 타입은 str이었고 값은 Read logs: keep timestamps였다. 설명의 뜻은 그대로 두고 YAML에서 문자열로 읽히도록 표기한 경우다.

name: log-reader
description:
  Read logs: keep timestamps

다음 줄에 설명을 들여쓴 위 입력도 파싱에 성공했다. 그러나 description은 dict가 됐다. 안에는 Read logs라는 키와 keep timestamps라는 값이 들어 있었다. YAML 구문으로는 읽을 수 있어도, 설명문 자리에 문자열을 기대하는 프로그램의 형식과는 맞지 않았다.

name: log-reader
description: Read logs: keep timestamps

따옴표와 줄바꿈을 모두 없앤 이 입력은 ScannerError로 실패했다. 오류 메시지는 mapping values are not allowed here였고, 설명문 안의 두 번째 콜론을 가리켰다. 콜론 뒤에 공백이 붙은 logs: keep 구문을 이 위치에 그대로 쓴 입력에서 오류가 난 것이다. 따라서 같은 문장을 놓고도 구문 오류, 문자열, 사전이라는 서로 다른 결과를 구별해야 했다.

여러 줄 표기가 모두 사전을 만드는 것은 아니다. description: > 아래에 같은 문장을 들여쓴 접힌 블록 표기는 이 실행에서 문자열이 됐다. 다만 값 끝에 줄바꿈이 하나 남았다. 따옴표로 감싼 값과 타입은 같아도 바이트까지 같다고 할 수는 없다. 이번 확인은 타입과 실제 값만 비교했으며, 그 끝 줄바꿈이 특정 스킬 로더에서 문제를 일으키는지는 시험하지 않았다.

검사를 붙인다면 두 질문을 나눌 수 있다. 먼저 YAML 파서가 읽을 수 있는가. 그다음 필요한 키가 있고 각 값이 프로그램이 요구한 타입인가. 이 예에서는 파싱에 성공한 사전 값이 두 번째 검사에서 탈락한다. 사람이 보기 좋은 설명을 쓰는 일과 그 설명이 문자열로 전달되는 일을 같은 검사에 맡기면 이 차이가 빠진다.

확인 범위는 Python 3.11.18과 PyYAML 6.0.3에서 읽은 작은 합성 YAML 본문이다. 실제 Markdown frontmatter 추출, 스킬 설치와 에이전트 로딩은 시험하지 않았다.

2026/11/20 10:28 2026/11/20 10:28

화면 조작 AI를 빼고 무해한 프로세스만 실행했는데도 같은 오류가 났다. 재개한 Windows Codex 대화에서 Computer Use 서버가 시작되지 않던 사건의 구별 근거다. 대화에 저장된 작업 폴더를 새 프로세스의 작업 디렉터리로 지정하자 Windows 오류 267이 재현됐다. 마우스를 움직이거나 화면을 읽기 전부터 실패할 조건이 있었다.

문제가 난 대화에는 예전에 쓰던 작업 폴더가 저장돼 있었다. 상위 폴더는 junction(정션)으로 다른 저장 위치에 연결돼 있었고 그 아래 날짜별 하위 폴더가 사라진 상태였다. 정션은 폴더를 다른 위치에 연결하는 기능이다. 상위 연결이 가리키는 위치가 있어도 대화에 저장된 전체 경로의 마지막 폴더는 없을 수 있다. 상위 폴더가 열린다는 확인만으로는 이 차이를 놓친다.

작업 디렉터리는 프로세스가 일을 시작하는 기준 폴더다. 화면 조작 서버도 프로세스로 실행되는 만큼 시작 조건에 이 폴더가 끼어들 수 있다. 여기서는 두 서버의 시작 실패 로그와 별도 프로세스 생성이 같은 오류를 보였다. 해당 대화가 넘기는 폴더부터 조사할 근거가 있었다. 화면 좌표나 클릭 방법을 바꿔 보는 실험은 이 시작 실패를 가르는 데 필요하지 않았다.

이 사례에서 유효했던 확인 순서는 짧다. 먼저 실패한 대화에 저장된 작업 디렉터리를 확인하고 정션을 지나는 경우 실제 목적지와 하위 폴더까지 확인한다. 필요하면 같은 폴더를 작업 디렉터리로 쓰는 무해한 프로세스로 시작 실패를 구별해 볼 수 있다. 오류 267이 언제나 같은 원인이라는 주장은 아니다.

폴더를 복원한 뒤에도 실제 화면 조작 확인이 남는다. 후속 기록에는 앱 목록 조회와 화면 캡처의 실제 도구 호출이 완료됐다고 남아 있다. 서버가 준비됐다는 표시에서 멈추지 않고 기능을 사용한 기록이다. 다만 이 읽기 전용 확인으로 클릭이나 입력을 포함한 모든 동작까지 검증한 것은 아니다.

같은 앱의 특정 대화에서만 기능이 시작되지 않는다면 앱 전체를 다시 설치하기 전에 그 대화가 어떤 폴더에서 일을 시작하려 하는지 확인할 만하다. 대화는 남아 있어도 작업 폴더는 정리되거나 옮겨질 수 있다. 이 사건에서는 화면 속 버튼을 고치기 전에 대화에 저장된 폴더와 실제 디스크 상태를 맞춰 봐야 했다.

2026/11/19 10:27 2026/11/19 10:27

배포 중에는 변경 적용을 기다리게 하되, 검토할 내용의 접수는 열어 둔다. 최근 한 AI 에이전트 운영 시스템이 잠금의 범위를 이렇게 나눴다. 배포 잠금이 잡혀 있다는 이유만으로 일반 검토를 깨우고 입력을 수집하는 단계까지 막던 조건을 제거했다. 실제 변경을 맡은 단계의 잠금과 재인증, 평가·적용·배포 절차는 그대로 남겼다.

여기서 잠금이 보호할 일과 그 때문에 멈춘 일이 어긋났다. 변경 적용을 보호하기 위해 둔 조건이 검토 입력을 받는 일도 막았다. 검토할 내용을 받아 두는 단계와 실제 변경 단계의 권한을 따로 다루면, 접수를 열면서도 적용 시점의 통제는 유지할 수 있다.

잠금을 없애지 않고 기다릴 자리를 바꾸기

수정 기록은 비차단 방식의 적용 범위도 한정했다. 지정된 호출자만 잠금을 즉시 얻지 못했을 때 기다리지 않는 방식을 쓰고, 다른 호출자의 기본 대기 동작은 유지했다. 비차단 획득은 잠금을 무시하고 통과한다는 말이 아니다. 잠금을 얻지 못했을 때 호출을 붙잡아 둘지 결정하는 방식이다. 검토 접수의 차단을 없앴다는 사실을 변경 단계의 잠금까지 없앴다는 뜻으로 읽으면 수정 범위가 달라진다.

가령 배포 중에 새 오류 보고가 들어온다고 가정해 보자. 보고를 보관하는 일과 그 보고를 근거로 실행 중인 프로그램을 바꾸는 일은 따로 다룰 수 있다. 다만 접수 과정 자체가 배포 중인 파일을 읽거나 공유 상태를 바꾼다면, 입력을 수집한 시점의 상태와 접수가 건드리는 정보를 확인해야 한다. 이 예시는 단계 구분에 필요한 조건을 보여준다. 이번 수정에 특정 보관 방식이나 버전 고정 기능이 구현됐는지는 확인하지 않았다.

검토가 끝난 시점과 수정이 작동한 시점

확인된 검증은 잠금이 잡힌 조건의 집중 회귀 시험과 구문 검사, 설치 소스의 고정 해시 대조다. 원래 진단 두 건도 정규 검토에서 후속 판단으로 대체됐다는 상태로 종결됐다. 그런데 그 정규 검토는 수정 설치 전에 이미 시작했다. 진단의 종결은 실제 결과지만, 그 결과를 새 코드의 운영 효과로 돌릴 시간 근거가 없다.

새 코드가 실제 운영에서 잠금이 잡힌 동안 검토를 수행하는 모습은 소스 기록에 관측되지 않았다. 회귀 시험 통과와 운영에서 같은 조건을 만났다는 증거는 따로 남는다. 처리 속도나 검토 누락 감소도 이 기록으로는 알 수 없다.

비슷한 대기 문제를 조사한다면 잠금을 가진 작업의 이름만 보지 말고, 멈춘 단계가 입력 접수인지 검토인지 변경 적용인지부터 나눠 볼 만하다. 같은 상태를 함께 바꾸는 작업에는 잠금이 필요할 수 있다. 그 상태를 건드리지 않는 입력 접수까지 기다리게 할지는 별도 판단이다. 이 사례에서 고친 것은 그 둘을 배포 잠금 하나로 함께 막던 조건이었다.

2026/11/18 10:28 2026/11/18 10:28

최근 한 AI 코드 검토 시스템은 공통 지침을 적용하는 순서를 고쳤다. 위반을 지적하기 전에 그 지침의 조건이 실제 코드와 수행 작업에 맞는지 먼저 확인하도록 했다. P-384에 관한 요구는 해당 경로에서 계속 검사하되 RSA·P-256 경로에 자동으로 적용하지 않도록 한 것이다. 지침을 전달받았다는 사실과 그 지침이 지금 코드에 적용된다는 판단을 나눴다.

원래 지침과 결과 해석기, 전체 검증 정책, 기존 검증·승인 기록은 그대로 두었다. 지침을 삭제하지 않고도 잘못 적용할 여지를 줄이려는 교정이다. AI 코드 검토에서 공통 지침을 읽는 단계와 개별 코드의 위반을 판단하는 단계 사이에 무엇이 필요한지 보여준다.

위반 문장보다 먼저 필요한 근거

가령 검토 지침에 ‘P-384를 사용하는 경우 이 조건을 확인한다’고 적혀 있다고 하자. 검토 의견에는 먼저 어떤 코드가 P-384를 사용하는지 드러나야 한다. 함수 이름에 서명이 들어간다는 이유만으로는 그 조건을 확인한 셈이 되지 않는다. 코드가 고르는 알고리즘과 실제 작업을 확인한 뒤 그 경로에서 요구를 지켰는지 살펴보는 순서다.

적용 여부를 확인할 자료가 빠졌다면 그 빈칸도 남겨야 한다. 호출한 함수는 보이는데 실제 알고리즘을 정하는 설정이 보이지 않는 상황을 가정해 보자. 이때 P-384 규칙 위반을 확정하거나 그 규칙과 무관하다고 확정하면 모두 확인하지 않은 조건을 대신 채운다. 검토 의견에는 무엇을 더 보면 적용 여부를 정할 수 있는지 쓰는 편이 낫다.

해당하지 않는 규칙과 검사하지 않은 코드는 다르다

반대로 RSA 경로가 있다는 이유로 같은 프로그램의 P-384 경로까지 검사에서 빼면 범위를 너무 넓게 제외한다. 조건은 프로그램 이름보다 실제로 검토하는 코드와 작업에 붙여야 한다. 이번 교정에서도 P-384 요구 자체는 유지했다. 공통으로 배포한 지침을 각각 검토할 수 있게 두되, 특정 조건의 요구를 모든 코드의 공통 의무로 바꾸지 않은 것이다.

이 교정의 범위는 AI 검토 지시다. 기존 검증·승인 기록은 바뀌지 않았으며, 교정 배포만으로 새 서명 작업의 성공이 확인되는 것도 아니다. 검토 정확도나 코드의 보안성 향상은 이 글에서 확인하지 않았다. 적용 조건을 맞추는 일과 그 뒤의 검사 결과를 확인하는 일은 따로 남는다.

검토 의견을 받을 때는 위반 문장 바로 앞에 빠진 사실이 없는지 볼 수 있다. 어느 코드가 어떤 작업을 하며, 그 때문에 이 규칙의 적용 대상이 되는가. 이 연결을 보여주면 같은 요구를 유지하면서도 검토할 범위를 좁힐 수 있다. 규칙 목록에 있다는 이유만 적힌 지적은 아직 그 코드의 위반을 설명하지 못했다.

2026/11/17 22:24 2026/11/17 22:24

“Failed to reboot system via logind: Access denied” 뒤에 “[PASS] Device reconnected.”가 찍혔다. 기기 반복 시험의 실제 출력에 함께 남은 문장이다. 앞에서는 재부팅 단계가 권한 오류를 냈고 뒤에서는 재연결을 성공으로 표시했다. 뒤의 성공 표시만으로 기기가 실제로 재부팅됐다고 판단하면 앞의 오류를 건너뛰게 된다.

이 캡처에는 재부팅 예고, 권한 거절을 포함한 여러 오류, 기기 연결을 기다린다는 안내, 재연결 성공 표시가 순서대로 나온다. 연결 여부와 재부팅 완료 여부는 서로 다른 확인 사항이다. 반복 시험에서 재부팅을 초기화 조건으로 삼았다면 다음 회차로 넘어가기 전에 그 조건을 따로 확인해야 한다.

가령 연결 대기 코드가 현재 연결 여부만 살핀다고 가정해 보자. 재부팅에 실패한 기기가 계속 연결돼 있어도 연결 검사는 참이 될 수 있다. 두 표시가 함께 나올 수 있는 한 가지 조건이다. 실제 시험 스크립트가 이 방식으로 작성됐는지는 확인하지 않았다. 성공 문구에서 검사 코드의 구현까지 거꾸로 추정해서는 안 된다.

재부팅 명령의 실행 대상도 확인할 항목이다. 기기를 재시작하려는 시험에서 오류가 났다면 명령이 시험용 컴퓨터에서 실행됐는지, 기기 안에서 실행됐는지 구별할 필요가 있다. 이 캡처만으로 실제 명령과 실행 대상을 확정하지 않았다. 권한 오류를 봤다는 이유만으로 곧장 관리자 권한을 추가하는 수정은 이 단계의 근거를 넘어선다.

진단을 추가한다면 재부팅 전후의 기기 부팅 식별자를 비교하는 방법을 검토할 수 있다. 기기가 그런 값을 제공한다면 명령을 보내기 전에 읽어 두고, 연결이 돌아온 뒤 같은 기기의 값을 다시 읽는 식이다. 식별자가 바뀌었는지와 단순히 연결됐는지를 나눠 기록한다. 이것은 제안하는 확인 방법이며 해당 시험에서 실행해 얻은 결과는 아니다.

스크립트 쪽에서는 재부팅 명령의 종료 상태와 출력, 후속 연결 검사의 조건을 함께 읽어야 한다. 명령 실패를 어느 분기에서 처리했는지 확인한 뒤 성공 표시를 붙일 위치를 정할 수 있다. 원문을 읽기 전에는 “종료 코드를 무시했다”거나 “성공 표시만 잘못됐다”는 원인을 확정할 수 없다. 이후 회차의 다른 실패가 재부팅 문제 때문에 생겼는지도 별도의 질문이다.

이 출력에서 확실히 남길 결론은 재부팅 단계의 오류와 후속 재연결 성공 표시가 함께 있다는 것이다. 실제 재부팅 여부는 미확인이다. 반복 시험을 계속하려면 연결 검사에 더해, 다음 회차가 요구하는 초기화가 실제로 일어났는지 확인해야 한다.

2026/11/17 10:36 2026/11/17 10:36

AI 대화 기록 화면을 설계한다고 하자. 목록에 ‘기획 회의’가 나란히 보인다. 두 항목이 같은 대화인지 알려면 제목보다 각 항목이 가리키는 세션 ID를 먼저 대조해야 한다. ID가 다르면 제목이 같은 별개 대화다. ID도 같다면 같은 대화가 목록에 겹쳐 나온 것인지 살펴볼 차례다. 제목 뒤에 번호를 붙이는 수정은 이 구별이 끝난 뒤의 일이다.

가령 서로 다른 대화에 ‘기획 회의’와 ‘기획 회의 (2)’라는 이름을 보여 줄 수 있다. 번호는 목록에서 고를 때 쓰는 표시다. 원래 세션 ID를 그대로 연결해야 이름을 바꾸거나 목록을 다시 정렬해도 선택한 대화로 돌아갈 수 있다. 이 설계에서 세션 ID는 각 대화를 고유하게 가리킨다는 전제다.

만약 같은 ID를 가리키는 항목이 두 번 나온 경우라면 사정이 다르다. 두 행에 각각 ‘기획 회의’와 ‘기획 회의 (2)’를 붙여도 열리는 본문은 같다. 이름만 달라져 중복이 눈에 덜 띌 뿐이다. 이런 가정에서는 별개 대화를 구별하는 표시를 고치기 전에 같은 기록이 목록에 두 번 들어온 이유를 살펴야 한다.

번호가 무엇을 세는지도 결정해야 한다. 제목이 겹친 순서인지, 생성된 순서인지 설명하지 않은 ‘(2)’는 두 번째로 만든 대화처럼 읽힐 수 있다. 오늘 목록의 둘째 항목이 내일도 같은 자리라는 보장은 없다. 화면에서 충돌을 피하려고 매긴 번호라면 그 번호를 대화의 영구 주소나 생성 순서로 취급해서는 안 된다. 날짜나 짧은 설명을 함께 보여 주는 대안도 검토할 수 있다.

제목을 다듬는 순서에는 읽기 권한도 걸려 있다. 사용자가 볼 수 없는 대화까지 모아 번호를 붙인 다음 숨긴다고 가정해 보자. 자기 목록에는 같은 제목이 하나뿐인데 ‘기획 회의 (3)’이 보일 수 있다. 번호가 다른 기록의 존재를 짐작할 단서가 된다. 이 설계에서는 먼저 볼 수 있는 기록을 고르고 그 안에서 제목 충돌을 처리하는 편이 그 단서를 줄인다. 본문을 열 때의 읽기 권한 확인은 별도로 남는다.

수정 전후를 확인한다면 이름이 서로 달라졌는지만 보면 부족하다. 같은 제목의 두 항목이 서로 다른 ID를 여는지, 이름을 바꾸거나 정렬한 뒤에도 원래 ID로 이어지는지, 같은 ID가 여러 행으로 보이는지를 따로 볼 수 있다. 위 화면은 가정 사례이며 특정 제품의 결함이나 개선 효과를 측정한 결과는 아니다. ‘기획 회의 (2)’를 보고 고르는 사람이 기대하는 것은 이름 하나가 더 있다는 사실보다 다른 대화가 열린다는 사실일 테다.

2026/11/16 10:37 2026/11/16 10:37

서버 쪽의 참·거짓 비교에서 CR이 덧붙은 값이 확인됐다. Windows에서 Python으로 파일 전송용 계정을 설정하던 작업이었다. 첫 인증 시험이 실패한 뒤 입력을 비교했더니, 원래 보내려던 값의 끝에 문자가 추가돼 있었다. 인증 실패라는 메시지보다 이 비교 결과가 원인을 더 좁혀 줬다.

해당 호출은 외부 명령의 표준 입력을 텍스트 모드로 보냈다. Windows에서 줄바꿈 문자 LF 앞에 CR이 추가됐고, 서버 쪽에는 CR이 붙은 값이 남았다. LF와 CR은 서로 다른 제어 문자다. 화면에서는 둘 다 줄바꿈 처리에 가려질 수 있지만, 값을 비교할 때는 끝에 붙은 CR도 내용의 일부가 된다.

이 지점에서 계정 설정과 입력 전달은 다른 조사 대상이 된다. 인증이 실패했다는 사실만으로 어느 쪽이 잘못됐는지 정할 수는 없다. 반면 CR이 붙은 값이 확인됐다는 기록은 전달 과정에서 무엇이 달라졌는지 가리킨다. 계정 설정을 다시 의심하기 전에, 텍스트를 외부 명령에 넘기는 경계를 살필 근거가 생긴 셈이다.

수정은 표준 입력을 바이트로 보내는 방식이었다. 텍스트 모드의 줄바꿈 변환을 피한 뒤 원래 지정한 값과의 일치가 확인됐고, 이어진 파일 전송 검사도 통과했다. 값이 맞는다는 확인과 그 값으로 원래 작업이 된다는 확인이 함께 남았다. 이는 기존 작업의 실패와 수정 기록이며, 이 글을 위해 새로 실행한 인증 실험은 아니다.

이 사례를 모든 문자열을 바이트로 보내라는 규칙으로 옮길 수는 없다. 받는 명령이 기대하는 문자 인코딩과 줄 구분자를 먼저 정해야 한다. 여기서 바이트 입력을 택한 이유는 전달하려던 값에 없던 CR이 텍스트 모드에서 추가됐기 때문이다. 다른 명령도 같은 조건인지는 별도로 확인할 일이다.

비슷한 실패를 조사할 때는 입력 문자열을 만든 코드만 보지 말고 외부 명령으로 넘기는 호출까지 이어서 볼 만하다. 문자열을 만들 때는 맞았어도 그다음 경계에서 줄바꿈이 바뀔 수 있다. 이 기록에서 수정 뒤 확인한 것은 “인증 오류가 안 보인다”보다 구체적이었다. 원래 값이 일치했고, 파일도 오갔다.

2026/11/16 05:08 2026/11/16 05:08

짧은 유효기간을 둔 Celery 작업 메시지가 아홉 시간이나 만료된 것으로 보였다. 한 컨테이너 배포에서 원인을 따라가 보니 ZoneInfo('UTC')가 돌려주는 시간대 오프셋부터 +09:00이었다. UTC를 요청했는데 한국 표준시의 오프셋이 나온 것이다.

한국 시간을 연결하다 UTC까지 바뀌었다

배포 기록에 남은 원인은 호스트의 한국 시간 설정을 컨테이너에 연결한 localtime 바인드 마운트였다. 바인드 마운트는 호스트의 파일을 컨테이너 안의 경로에 연결하는 방식이다. 이 이미지의 /etc/localtime은 공유 UTC 시간대 파일을 가리키는 심볼릭 링크였다. 마운트가 그 링크를 따라가 UTC 시간대 파일을 덮었다. 한국 시간으로 표시하려던 설정이 UTC로 읽는 데이터까지 바꾼 셈이다.

따라서 이 사례에서는 localtime 경로가 있다는 사실만으로 설정을 판단할 수 없었다. 그 경로가 다른 시간대 파일로 이어지는 링크라는 점이 실패 원인에 포함됐다. UTC라는 이름으로 읽었는지와 실제로 UTC 오프셋을 얻었는지도 따로 확인할 필요가 있었다.

수정은 Dockerfile에서 마운트 전에 /etc/localtime을 일반 파일로 만드는 것이었다. UTC 파일로 이어지는 링크를 없애고 localtime 자체를 마운트 지점으로 뒀다. 호스트의 한국 시간 표시와 마운트는 유지했다. 한국 시간 표시를 전부 없애는 대신 마운트가 영향을 주는 파일을 바꿨다.

마운트한 상태의 숫자로 수정 전후를 비교했다

실제로 마운트한 프로브를 비교한 기록에서 epoch 오차는 -32,400초에서 약 0초로 바뀌었다. 최종 API의 UTC 오프셋도 0으로 유지됐고 정기 작업은 자연 일정에서 실행됐다. 일반 파일로 고친 코드만 확인한 것이 아니라 마운트가 있는 조건의 시간 값과 이후 실행까지 확인한 결과다.

이 수치는 이번 글에서 새로 실행한 실험이 아니라 해당 배포의 수정 전후 기록이다. 다른 이미지의 localtime 구성이나 모든 Celery 만료 오류를 확인한 결과는 아니다. 이 사례의 조사 대상은 컨테이너 안에서 UTC 시간대가 한국 시간 오프셋으로 해석된 상태였다.

메시지 유효기간만 늘리는 방법은 이 기록에서 검증한 해결책이 아니다. 비슷한 증상을 조사한다면 localtime을 연결한 뒤 애플리케이션이 읽는 UTC 오프셋과 링크가 가리키는 파일부터 함께 확인할 만하다. 이 배포에서 먼저 고쳐야 했던 것은 메시지를 받아들이는 시간 범위보다 UTC가 +09:00을 반환하는 상태였다.

2026/11/15 22:22 2026/11/15 22:22