문자열 치환 패치 스크립트가 일으킨 세 가지 사고와 막는 법

먼저 결론

겪은 일: 패치 스크립트가 "고침"이라고 찍었는데 적용이 안 됐거나, 함수 하나를 바꿨더니 다른 함수들이 사라졌거나, 치환 뒤 화면 파일 전체가 문법 오류로 죽었습니다.

원인: 끝에 한 번 저장하는 구조에서 중간에 죽었고, 끝 앵커가 실제 다음 함수가 아니었고, 앵커가 닫는 따옴표를 빠뜨렸습니다.

이렇게 풀었다: 앵커는 먼저 grep 으로 확인하고, 교체 전후 함수 목록을 비교하고, 임시 파일로 문법 검사를 통과할 때만 실제 파일에 씁니다.

큰 파일을 고칠 때 "이 문자열을 찾아 저 문자열로 바꾼다"는 패치 스크립트를 자주 씁니다. 파일을 통째로 올리는 것보다 안전하고, 남이 바꾼 부분을 건드리지 않아서입니다. 그런데 이 방식에도 고유한 사고가 있습니다. 관리 화면 파일과 문서를 고치다 실제로 겪은 세 가지를 적습니다.

세 사고를 한눈에

사고 무엇이 일어났나 원인 막는 장치
가. 중간 사망 7개 중 4개 "고침" 뒤 5번째에서 죽음, 4개도 저장 안 됨 끝에 한 번 저장, 앵커 추측 파일을 다시 읽어 세기, 치환마다 저장
나. 함수 소실 homeRight is not defined, 함수 3개 사라짐 끝 앵커가 실제 다음 함수가 아님 교체 전후 함수 목록 비교
다. 고아 따옴표 화면 파일 전체가 문법 오류, 빈 화면 앵커가 닫는 따옴표를 빠뜨림, 쓰고 나서 검증 임시 파일로 검사 뒤 저장

가. "고침" 네 줄이 거짓이었던 날

관리 화면 파일 한 곳에 치환 7개를 거는 스크립트를 돌렸습니다. 화면에 "고침: A", "고침: B" 가 네 줄 찍히고 5번째 앵커가 안 맞아 스크립트가 멈췄습니다. 앞의 네 개는 들어갔다고 생각하고 배포했고, 검증 스크립트까지 통과했습니다. 그 네 개는 검증 대상이 아니었습니다.

바뀐 화면을 눈으로 보고서야 옛날 그대로인 것을 알았습니다. 스크립트는 모든 치환을 메모리에서 끝낸 뒤 마지막에 한 번 저장하는 구조였고, 중간에 sys.exit 하면서 저장 단계에 가지 못했습니다. "고침"은 메모리 안에서 바꿨다는 뜻이었을 뿐입니다.

5번째가 죽은 이유도 단순했습니다. 앵커를 기억으로 짐작해 slice(0,46) 이라고 넣었는데 파일의 실제 문자열은 slice(0,42) 였습니다. 같은 실수를 문서 작업에서 한 번 더 했습니다.

grep -n "slice(0," admin.js            # 앵커는 넣기 전에 실제 문자열을 본다
python3 patch.py
grep -c "새로 넣은 문구" admin.js      # 로그가 아니라 파일을 센다

중간 실패가 잦은 스크립트라면 치환마다 저장하거나, 실패해도 그때까지를 저장하고 어디서 멈췄는지 남깁니다.

나. 끝 앵커 하나가 함수 셋을 지웠다

큰 자바스크립트 파일에서 cohortCard 함수를 통째로 바꾸면서, 시작은 function cohortCard, 끝은 다음 함수라고 생각한 function trafficTrendCard 로 잡았습니다. 실제 다음 함수는 maturityCard 였습니다.

그 사이에 있던 maturityCard, pubFlowCard, homeRight 가 통째로 날아갔습니다. 검증 스크립트가 homeRight is not defined 로 바로 잡아 백업으로 되돌렸습니다. node --check 같은 문법 검사로는 못 잡습니다. 함수가 사라져도 문법은 멀쩡하기 때문입니다.

지금은 끝 앵커를 쓰기 전에 실제 다음 함수를 보고, 패치 스크립트 안에서 교체 전후 함수 목록을 비교합니다.

grep -n "^function " admin.js | sed -n "/cohortCard/,+3p"
before = set(re.findall(r'^function ([A-Za-z_$][\w$]*)\s*\(', s, re.M))
# ... 교체 ...
after = set(re.findall(r'^function ([A-Za-z_$][\w$]*)\s*\(', s, re.M))
lost = before - after
if lost: raise SystemExit('[FAIL] 사라진 함수: ' + ', '.join(sorted(lost)))

다. 닫는 따옴표 하나와 빈 화면

또 다른 날에는 앵커가 자바스크립트 문자열의 닫는 따옴표 바로 앞에서 끝났습니다. 치환하고 나니 짝 없는 따옴표가 하나 남았고, 화면 파일 전체가 문법 오류로 죽어 열면 빈 화면이었습니다. "쓰고 나서 검증"하는 순서라 검증을 돌리기까지 라이브가 죽어 있었습니다.

그래서 순서를 바꿨습니다. 결과를 먼저 임시 파일에 쓰고, 문법 검사를 통과할 때만 실제 파일에 옮깁니다. 실패하면 원본은 아예 건드리지 않습니다.

import subprocess, os
tmp = path + ".tmp"
open(tmp, "w", encoding="utf-8").write(new_text)
if subprocess.run(["node", "--check", tmp]).returncode != 0:
    os.remove(tmp)
    raise SystemExit("[FAIL] 문법 오류, 원본 그대로")
os.replace(tmp, path)

파이썬 파일이라면 ast.parse 로 같은 일을 합니다. 앵커는 따옴표에서 끝나지 않게 자릅니다. 닫는 따옴표까지 넣거나, 따옴표가 아닌 안전한 글자에서 끊습니다. 파이썬 삼중 따옴표 안에 넣은 앵커가 따옴표로 끝나면 패치 스크립트 자체의 문법이 깨지기도 합니다.

이 절차를 넣은 뒤에도 같은 실수를 한 번 더 했습니다. 그때는 사전 검사가 막아서 원본이 멀쩡했습니다. 주의력에 기대지 않고 절차로 막아야 한다는 것을 그때 확인했습니다.

패치를 이렇게 정밀 치환으로 하는 이유 하나는, 다른 작업자가 같은 파일을 덮어써도 내 블록만 다시 얹기 쉽기 때문입니다. 그 사고는 서버 로컬 git 에 여럿이 커밋하다 남의 수정이 사라질 때에 적었고, 검사를 통과했는데 라이브가 죽은 다른 경우는 검사를 통과했는데 라이브가 죽었을 때를 보세요.

워드프레스 글 본문을 스크립트로 고치다 생긴 사고는 본문을 스크립트로 고치다 글이 망가진 세 가지에 따로 적었습니다.

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