셸 한 줄로 잠금을 잡고 작업한 뒤 정리하는 스크립트를 쓰거나, zsh에서 커밋 해시를 변수에 담아 git push를 조립하는 분이라면 이 두 사고를 먼저 확인해 볼 만하다. 내 에이전트 하네스가 2026-11-05에 저장소 하나를 병합하고 승격하는 동안 셸 명령 때문에 두 번 일이 틀어졌다. 첫 번째는 mkdir로 잠금을 잡지 못했는데도 ;로 이어 둔 정리 명령이 그대로 실행돼, 다른 조정 세션이 쥐고 있던 병합 대기열 잠금을 지운 일이다. 두 번째는 zsh가 $S:refs의 :r을 변수 수정자로 해석해 첫 승격 push가 실패한 일이다. 고친 방법은 각각 "정리는 잠금을 얻은 분기 안에서만"과 "${S}처럼 중괄호로 감싸기"다. 이 글은 기록에 남은 사실과 이 Mac에서 다시 재현한 결과를 나눠서 다룬다. 이 글은 작성자의 작업 기록을 바탕으로 Claude 모델이 초안을 작성했다.

기록에 남은 두 사고

당시 작업은 개인 라우터 도구의 메인 코드를 Rust에서 Python으로 옮기는 실행이었다. 2026-11-04부터 11-05까지 PR 일곱 개를 develop에 병합했고, 마지막에 main을 fast-forward로 승격했다. 같은 저장소에서는 다른 조정 세션도 별도 작업을 돌리고 있었다. 두 세션이 동시에 병합하지 않도록, 병합 대기열은 디렉터리 하나를 잠금으로 썼다. 잠금을 쥔 쪽은 그 안에 소유자 정보를 담은 owner.json을 둔다.

실행 기록에 남은 사실은 다음과 같다.

실행 기록에 남은 두 사고
항목잠금 사고push 사고
시각2026-11-05T00:48:49Z(KST 09:48)첫 승격 push 시점(정확한 시각은 기록 없음)
무엇이 일어났나mkdir 실패 뒤 ;로 이어진 정리가 다른 조정 세션의 잠금 디렉터리와 owner.json을 지움zsh의 $S:refs 수정자 해석으로 push 실패
피해잠금이 없는 동안 병합은 일어나지 않음승격이 한 번 늦어짐
조치디렉터리를 다시 만들고 restored_by를 적은 owner.json을 둠${S}로 고쳐 다시 push
이후 규칙정리는 잠금 획득에 성공한 분기 안에서만 실행변수 뒤에 콜론이 오면 중괄호 사용

두 사고 모두 당시의 정확한 명령 원문은 기록에 없다. 그래서 아래의 재현은 기록에 적힌 모양(;로 이어진 정리, $S:refs)을 바탕으로 내가 다시 만든 최소 예시다. 2026-11-08에 이 Mac의 zsh 5.9와 macOS 기본 bash 3.2.57로 실행했다.

실패한 잠금 뒤에 실행된 정리

mkdir을 잠금으로 쓰는 이유는 간단하다. 디렉터리가 이미 있으면 mkdir은 실패하고, 만들기와 존재 확인이 한 번의 호출로 끝난다. POSIX 명세는 mkdir의 종료 상태를 "All the specified directories were created successfully"일 때 0, 그 밖의 오류에서 0보다 큰 값으로 정한다. 잠금은 이 종료 상태를 믿고 만든 장치다.

문제는 그 종료 상태를 아무도 보지 않을 때 생긴다. 기록의 모양을 따라 만든 나쁜 예시는 다음과 같다.

L=q.lock
mkdir "$L" 2>/dev/null; echo "work under lock"; rm -rf "$L"

다른 소유자가 이미 잠금을 쥔 상태를 만들고 실행했다.

$ mkdir q.lock && echo '{"owner":"other"}' > q.lock/owner.json
$ zsh -f bad.sh; echo "rc=$?"; ls q.lock
work under lock
rc=0
ls: q.lock: No such file or directory

결과는 세 가지 면에서 나쁘다.

  1. mkdir이 실패했는데도 "잠금 아래의 작업"이 실행됐다. 잠금이 아무것도 막지 못했다.
  2. 마지막 rm -rf가 다른 소유자의 디렉터리와 owner.json까지 지웠다. 기록의 사고가 바로 이 부분이다.
  3. 종료 코드가 0이다. 호출한 쪽은 실패를 알 길이 없다.

bash 매뉴얼은 ;를 이렇게 설명한다. "Commands separated by a ‘;’ are executed sequentially". 그리고 리스트의 반환 상태는 마지막 명령의 종료 상태다. 그러니 ;로 이은 줄에서 앞 명령의 실패는 뒤 명령의 실행 여부에 아무 영향을 주지 않는다. 마지막 rm이 성공하면 줄 전체도 성공으로 보인다.

잠금을 지우는 권리는 잠금을 만든 쪽에만 있다. 정리 코드가 "내가 이 잠금을 얻었는가"를 확인하지 않으면, 그 코드는 남의 잠금을 지우는 코드가 된다.

사고 뒤에는 지워진 경로에 디렉터리를 다시 만들고, 원래 소유자 대신 누가 복원했는지 적은 restored_by 항목을 owner.json에 넣었다. 기록에 따르면 잠금이 사라져 있던 동안 병합은 일어나지 않았다. 그때 대기 중이던 문서 동기화 PR도 그 사이에 병합되지 않았다. 운이 좋았던 부분이다. 그 틈에 다른 세션이 잠금을 새로 잡았다면, 두 세션이 동시에 병합할 수 있는 상태가 만들어졌을 것이다. 이 마지막 문장은 추정이며 실제로 일어난 일은 아니다.

잠금을 얻은 분기 안에서만 정리하기

기록에 남은 이후 규칙은 한 줄이다. "정리는 잠금 획득에 성공한 분기 안에서만 실행한다." 이를 셸로 옮긴 예시는 다음과 같다.

L=q.lock
if mkdir "$L" 2>/dev/null; then
  trap 'rm -rf "$L"' EXIT
  echo "work under lock"
else
  echo "lock held by another owner; not touching it" >&2
  exit 75
fi

같은 조건에서 다시 실행했다.

$ zsh -f good.sh; echo "rc=$?"; ls q.lock
lock held by another owner; not touching it
rc=75
owner.json

$ rm -rf q.lock; zsh -f good.sh; echo "rc=$?"; ls q.lock
work under lock
rc=0
ls: q.lock: No such file or directory

다른 소유자가 잠금을 쥐고 있으면 작업도 정리도 하지 않고, 0이 아닌 코드로 끝난다. 잠금이 비어 있으면 작업하고, 끝날 때 자기가 만든 잠금만 지운다. trap ... EXIT을 성공 분기 안에서 거는 이유도 같다. 분기 밖에서 걸면 실패한 경로에서도 정리가 실행돼 처음 문제로 돌아간다. 종료 코드 75는 내가 예시에서 고른 값이다. 당시 도구가 어떤 코드를 썼는지는 기록에 없다.

아래 그림은 같은 mkdir 실패가 ; 연결과 성공 분기 구조에서 어떻게 다른 결과로 이어지는지 비교한다.

다섯 단계 흐름도다. 1단계에서 다른 소유자가 이미 잠금 디렉터리를 쥐고 있어서, 2단계 mkdir 잠금 획득은 0보다 큰 종료 상태로 실패한다. 그런데 이 실패를 확인하지 않아 ;로 이어진 3단계 잠금 아래 작업이 그대로 실행된다. 4단계에서 정리 명령 rm -rf가 다른 소유자의 잠금 디렉터리와 owner.json까지 지운다. 5단계에서는 마지막 rm이 성공했으므로 줄 전체의 종료 코드가 0이 되어, 호출한 쪽은 실패를 알 수 없다.
정리 코드가 잠금을 자기가 얻었는지 확인하지 않으면, 실패한 잠금도 성공처럼 보이고 남의 잠금을 지우는 결과로 이어진다.

세 가지 연결 방식을 표로 정리하면 이렇다.

잠금 획득 실패 때 연결 방식별 동작
연결 방식작업 실행남의 잠금 삭제호출자가 보는 종료 코드
mkdir; 작업; rm실행됨삭제됨마지막 rm의 코드(재현에서 0)
mkdir && 작업 && rm실행 안 됨삭제 안 됨mkdir의 실패 코드. 다만 작업이 실패하면 rm도 건너뛰어 내 잠금이 남는다
if mkdir; then trap; 작업; else exit 75; fi실행 안 됨삭제 안 됨지정한 실패 코드. 성공 경로에서는 작업 결과와 무관하게 내 잠금을 지운다

&&만으로도 남의 잠금은 지키지만, 작업이 중간에 실패하면 자기 잠금을 남겨 다음 실행을 막는다. bash 매뉴얼의 정의대로 && 뒤 명령은 앞 명령이 0을 돌려줄 때만 실행되기 때문이다. 그래서 성공 분기와 trap을 함께 쓰는 형태를 골랐다.

하나 더 주의할 점이 있다. 잠금용 mkdir에 습관처럼 -p를 붙이면 안 된다. POSIX 명세는 -p가 있으면 디렉터리가 이미 있어도 성공으로 본다고 적는다. 그러면 잠금이 늘 "획득 성공"으로 보인다. 당시 사고에서 -p가 쓰였다는 기록은 없다. 이 문단은 같은 구조에서 생길 수 있는 다른 실수를 적어 둔 것이다.

zsh가 :r을 수정자로 읽은 push

두 번째 사고는 승격 단계에서 났다. 승격은 검증한 커밋을 원격 main으로 fast-forward push하는 작업이다. 기록된 $S:refs라는 모양으로 보아 커밋 SHA를 변수 S에 담아 refspec을 조립한 것으로 보인다. 기록에는 "zsh의 $S:refs 수정자 해석으로 첫 승격 push가 실패했고 ${S}로 고쳤다"고만 남아 있다. 같은 모양을 zsh와 bash에서 재현했다.

$ zsh -fc 'S=7cb24e5; echo "push origin $S:refs/heads/main"; echo "push origin ${S}:refs/heads/main"'
push origin 7cb24e5efs/heads/main
push origin 7cb24e5:refs/heads/main

$ bash -c 'S=7cb24e5; echo "push origin $S:refs/heads/main"'
push origin 7cb24e5:refs/heads/main

zsh에서는 :r이 사라지고 efs/heads/main만 남았다. zsh 매뉴얼의 Modifiers 절은 변수 확장 뒤에 콜론으로 시작하는 수정자를 붙일 수 있다고 설명한다. 그중 r은 "Remove a filename extension leaving the root name"이다. 그래서 $S:r까지가 "S에서 확장자를 뗀 값"으로 해석됐다. 7cb24e5에는 점이 없으니 값은 그대로 남았고, 콜론과 r만 사라졌다. 나머지 efs/heads/main은 그 뒤에 글자 그대로 붙었다.

값에 점이 있으면 결과가 더 이상해진다. 재현에서 S=release.v2로 바꾸자 releaseefs/heads/main이 나왔다. 확장자 .v2까지 잘려 나간 것이다.

:r만 문제가 아니다. 콜론 뒤 첫 글자가 다른 수정자 글자와 겹치면 비슷한 일이 생긴다. 같은 날 같은 zsh 5.9에서 흔히 쓰는 콜론 뒤 단어 몇 개를 넣어 확인했다. 모두 큰따옴표 안에서 zsh -f로 실행했다.

zsh에서 변수 뒤 콜론 단어가 바뀐 재현 결과
입력출력읽힌 수정자
D=/srv/app; "$D:tmp"appmp:t(경로의 마지막 부분)
H=server1; "$H:home".ome:h(경로의 앞부분. 슬래시가 없어 .)
D=/srv/app; "$D:etc"tc:e(확장자. 없으니 빈 값)
H=server1; "$H:latest"server1atest:l(소문자로)
T=v1.2; "$T:abc"현재 작업 디렉터리 절대 경로 뒤에 v1.2bc:a(절대 경로로)
U=deploy; "$U:staff"bad substitution 오류:s(치환. 형식이 맞지 않음)
H=server1; "${H}:home"server1:home없음

오류로 멈춘 것은 :s 한 경우뿐이었다. 나머지는 조용히 다른 문자열을 만들었다. :a는 작업 디렉터리 경로까지 끌어와 붙였으니, 로그에 찍히면 내부 경로가 새어 나갈 수도 있다. 마지막 줄처럼 중괄호를 쓴 경우만 모두 의도대로 나왔다.

아래 그림은 같은 push 문자열을 중괄호 없이 썼을 때와 썼을 때를 나란히 놓은 것이다.

두 열을 나란히 비교한 그림이다. 왼쪽 열은 중괄호 없이 쓴 $S:refs/heads/main이다. zsh가 :r을 확장자를 떼는 수정자로 읽어 콜론과 r이 사라지고 efs/heads/main만 남아 첫 승격 push가 실패했다. 오른쪽 열은 중괄호로 감싼 ${S}:refs/heads/main이다. 콜론이 수정자로 읽히지 않고 그대로 남아 zsh와 bash에서 같은 결과를 낸다.
zsh에서는 변수 바로 뒤에 붙은 콜론이 수정자로 읽힐 수 있으므로, 중괄호로 변수 이름이 끝나는 곳을 밝혀야 refspec이 의도대로 조립된다.

같은 줄이 bash에서는 의도대로 동작했다. 그래서 bash에서 먼저 써 본 명령을 zsh 세션에 옮기면 이 차이를 놓치기 쉽다. 이 하네스의 셸은 zsh다. 고친 방법은 변수 이름 끝을 중괄호로 분명히 하는 것이다. "${S}:refs/heads/main"은 두 셸에서 같은 결과를 냈다.

push가 잘못된 refspec 때문에 실패한 것은 차라리 다행이다. 수정자가 만든 문자열이 우연히 유효한 refspec이 되었다면, 실패 없이 엉뚱한 곳으로 push됐을 수 있다. 이 문장도 추정이며, 당시 실패 메시지의 원문은 기록에 없다.

셸 명령 점검 목록

두 사고에서 다음 번에 쓸 항목을 뽑았다. 모두 위의 기록이나 재현에서 나온 것이다.

  • 잠금 획득과 정리를 ;로 잇지 않는다. 정리는 if mkdir ...; then의 성공 분기 안에 둔다.
  • trap ... EXIT은 잠금을 얻은 뒤에 건다.
  • 잠금용 mkdir에는 -p를 붙이지 않는다.
  • 잠금 디렉터리에는 소유자 정보를 남긴다. 사고가 나면 누가 복원했는지도 남긴다.
  • zsh에서 변수 바로 뒤에 콜론이 오면 ${VAR}로 쓴다. refspec, host:path, user:group 같은 자리가 해당한다.
  • bash에서 확인한 명령을 zsh에서 실행하기 전에, echo로 확장 결과를 한 번 찍어 본다.

셸 명령의 작은 차이로 생긴 다른 사고도 정리해 둔 글이 있다. 따옴표 없는 heredoc에서 명령 치환이 실행된 사례는 heredoc 명령 치환 기록에 있다. git 훅 검사가 복합 명령과 작업 디렉터리 때문에 무력해진 사례는 git 훅 복합 명령 기록에 있다. zsh nvm 지연 로딩이 셸 스냅샷에서 재귀한 문제는 zsh nvm 지연 로딩 기록에서 다뤘다. 다른 글은 프로그래밍 카테고리에서 볼 수 있다.

기록이 말하지 않는 것

  • 두 사고의 명령 원문과 오류 출력은 남아 있지 않다. 위의 나쁜 예시와 zsh 출력은 기록에 적힌 모양을 따라 2026-11-08에 내가 다시 만든 재현이다.
  • 잠금 사고에서 mkdir이 실패한 이유는 기록에 없다. 다른 세션이 잠금을 쥐고 있었다는 것만 남아 있다.
  • 잠금이 사라진 시간이 얼마였는지는 기록되지 않았다. 그 사이 병합이 없었다는 사실만 확인돼 있다.
  • "다른 세션이 끼어들었을 경우"와 "잘못된 refspec이 유효했을 경우"는 추정이다. 실제로 일어나지 않았다.
  • 재현은 zsh 5.9와 bash 3.2.57에서만 했다. 다른 버전이나 옵션(setopt)에서 같은 결과가 나오는지는 확인하지 않았다.

두 사고는 셸 문법이 개발자의 의도와 다르게 명령을 읽은 경우다. 잠금은 실패를 무시한 연결 방식 때문에, push는 변수 이름의 경계 때문에 틀어졌다. 이번에 확인한 것은 하나다. 셸 한 줄은 쓴 사람의 의도가 아니라 셸의 규칙대로 실행되므로, 그 규칙을 문장 구조로 드러내 써야 한다.

자주 묻는 질문

mkdir이 잠금으로 쓰이는 이유는 무엇인가요?

디렉터리가 이미 있으면 mkdir이 실패하므로, 만들기와 존재 확인이 한 번의 호출로 끝납니다. 이 성질은 종료 상태를 확인할 때만 잠금으로 작동합니다.

세미콜론 대신 &&만 쓰면 충분한가요?

남의 잠금은 지키지만, 작업이 중간에 실패하면 정리도 건너뛰어 자기 잠금이 남습니다. 그래서 잠금 획득의 성공 분기 안에서 trap으로 정리를 거는 형태를 썼습니다.

zsh에서 $S:refs가 왜 바뀌나요?

zsh는 변수 뒤의 :r을 확장자를 떼는 수정자로 해석합니다. 그래서 :r이 사라지고 efs/heads/main만 붙습니다. ${S}:refs처럼 중괄호로 변수 이름의 끝을 표시하면 bash와 같은 결과가 나옵니다.

지워진 잠금은 어떻게 복구했나요?

같은 경로에 디렉터리를 다시 만들고, 복원한 쪽을 적은 restored_by 항목을 owner.json에 넣었습니다. 잠금이 없던 동안 병합은 일어나지 않았습니다.

참고한 자료