짧은 유효기간을 둔 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