.env를 고쳤는데 봇은 계속 옛날 설정으로 돌았다: 오래 떠 있는 프로세스와 환경변수 상속
코인 자동매매 봇에는 웹 대시보드가 붙어 있습니다. 봇 시작·정지, 코인 추가, 전략 수치 조정 같은 걸 버튼으로 할 수 있고, 모의투자와 실거래를 전환하는 스위치도 있습니다. 실수로 실거래가 켜지면 안 되니, 이 스위치는 확인 문구를 직접 입력해야만 켜지게 만들었습니다.
스위치를 켜고 봇이 재시작된 걸 확인했습니다. 그런데 봇 로그 첫 줄에 이렇게 찍혀 있었습니다.
모드=DRY-RUN(모의)
.env 파일을 열어보면 분명히 UPBIT_DRY_RUN=false로 바뀌어 있었습니다. 파일은 바뀌었는데 봇은 옛날 값을 읽고 있었습니다.
구조부터 보면
프로세스 관계는 이렇습니다.
| 프로세스 | 수명 | 하는 일 |
|---|---|---|
| dashboard.py (systemd 서비스) | 며칠째 계속 떠 있음 | 버튼을 누르면 감시 스크립트를 실행 |
| watchdog.sh | 짧음 | 봇이 꺼져 있으면 띄움 |
| main_trade.py | 봇 재시작마다 새로 뜸 | 시작할 때 .env를 읽고 매매 |
봇은 매번 새로 뜨니까 매번 .env를 새로 읽을 거라고 생각했습니다. 여기가 틀린 부분이었습니다.
원인: 부모의 낡은 환경변수가 자식에게 그대로 물려진다
대시보드도 시작할 때 설정 모듈을 import하면서 load_dotenv()를 호출합니다. 이때 .env의 값이 대시보드 프로세스의 os.environ에 들어갑니다. 대시보드가 떠 있던 며칠 전 시점의 값, 즉 UPBIT_DRY_RUN=true입니다.
스위치를 누르면 대시보드는 .env 파일을 false로 고치고, 봇을 재시작하려고 이렇게 실행했습니다.
subprocess.Popen(["bash", WATCHDOG_SH])
env 인자를 주지 않으면 자식 프로세스는 부모의 환경변수를 그대로 물려받습니다. 그래서 봇은 태어날 때부터 UPBIT_DRY_RUN=true를 갖고 시작합니다.
그다음이 결정적이었습니다. 봇 안에서 호출하는 load_dotenv()는 기본값이 override=False입니다. 이미 환경변수에 있는 값은 .env 값으로 덮어쓰지 않는다는 뜻입니다. 봇은 .env를 분명히 읽었지만, 이미 있던 낡은 값을 그대로 두었습니다.
대시보드 시작 (며칠 전): os.environ["UPBIT_DRY_RUN"] = "true"
스위치 클릭: .env 파일 → false
Popen: 자식이 "true"를 물려받음
봇의 load_dotenv(): 이미 있으니 무시 → 계속 "true"
세 가지가 각각은 모두 정상 동작입니다. 합쳐지니 버그가 됐습니다.
고친 방법
봇을 띄울 때마다 .env를 새로 읽어서, 그 값으로 환경을 명시적으로 덮어쓴 뒤 넘기게 바꿨습니다.
from dotenv import dotenv_values
def start_bot():
env = {**os.environ, **dotenv_values(ENV_PATH)} # .env가 항상 이긴다
subprocess.Popen(["bash", WATCHDOG_SH], env=env)
이렇게 하면 대시보드를 재시작하지 않아도 봇은 항상 최신 .env로 시작합니다. 봇 쪽에서 load_dotenv(override=True)로 바꾸는 방법도 있지만, 그러면 시스템에서 의도적으로 준 환경변수까지 .env가 덮어쓰게 됩니다. 문제의 출발점인 “넘겨주는 쪽”을 고치는 게 더 정확하다고 판단했습니다.
수정 후 스위치를 다시 눌렀더니 로그에 실거래 모드가 찍혔고, 업비트 실제 잔고 조회도 정상으로 됐습니다.
이게 왜 무서운 버그인가
이번에는 방향이 “실거래를 켰는데 모의로 돈다”여서 피해가 없었습니다. 반대 방향이었다면 이야기가 다릅니다. 실거래를 끄고 모의로 바꿨다고 믿는 동안 실제 돈으로 매매가 계속되는 상황도 똑같은 구조에서 생길 수 있습니다. 설정 화면이 “모의”라고 보여주는 것과 봇이 실제로 쓰는 값이 다를 수 있다는 점이 핵심입니다.
이번에 바로 알아챌 수 있었던 건 봇이 시작할 때 자기가 실제로 읽은 모드를 로그 첫 줄에 찍고 있었기 때문입니다. 이 한 줄이 없었다면 한동안 실거래 중이라고 믿고 있었을 겁니다. 설정을 바꾸는 기능을 만든다면, 화면의 스위치 상태가 아니라 프로그램 자신이 보고하는 값을 확인하는 장치를 꼭 같이 두시길 권합니다.
같은 함정이 숨어 있는 곳
- 웹 대시보드, 작업 스케줄러, 감시 데몬처럼 오래 떠 있으면서 다른 프로세스를 띄우는 프로그램
- docker 컨테이너 안에서 환경변수를 한 번 받고 시작한 뒤 설정 파일만 바꾸는 경우
- 터미널을 오래 열어둔 채
.env를 고치고, 같은 터미널에서export된 옛 값이 남아 있는 경우
“파일을 고쳤다”와 “프로그램이 새 값을 쓴다” 사이에는 생각보다 많은 단계가 있습니다. python-dotenv의 override 동작은 공식 저장소 README에 설명돼 있는데, 저는 이 일을 겪기 전까지 한 번도 제대로 읽어보지 않았습니다.