설정값은 대체 어디서 오는가: import * 로 몰래 묶인 두 봇과, 코드를 이긴 .env
한 서버에서 여러 개의 매매 봇을 돌리고 있습니다. 코인 현물, 해외선물 단타, 해외선물 스윙, 국내주식까지 각자 설정 파일이 있습니다. 설정 하나를 바꿀 때 제가 원하는 봇에만, 원하는 값으로 적용되는지는 당연한 일처럼 보입니다. 같은 주에 이 당연한 게 두 번 깨졌습니다.
사건 1: “완전히 분리한다”고 적힌 설정 파일
스윙 봇 설정 파일 맨 위에는 이런 설명이 있었습니다.
"""
해외선물 스윙 설정. 단타 상태/DB와 완전히 분리한다.
"""
from futures_config import *
TIMEFRAME = "4h"
DONCHIAN_PERIOD = 80
...
설명은 “완전히 분리”인데 첫 줄이 from futures_config import *입니다. 단타 설정을 전부 가져온 다음 일부만 덮어쓰는 구조입니다. 그러면 스윙 파일에서 명시적으로 덮어쓰지 않은 값은 단타 설정을 그대로 따라갑니다.
이걸 알게 된 건 단타 봇의 레버리지를 1배에서 2배로 올리던 날이었습니다. 스윙 파일에는 레버리지 설정이 없었습니다. 그대로 뒀다면 백테스트를 1배로 검증한 스윙 전략이 아무도 모르게 2배로 돌아갈 뻔했습니다. 가상 시작 잔고도 마찬가지로 단타 값을 따라가고 있었습니다.
고친 방법은 단순합니다. 스윙이 자기 값을 가져야 하는 설정을 스윙 파일에 직접 적었습니다.
from futures_config import *
FUTURES_LEVERAGE = 1.0 # 백테스트 검증값. 단타 설정과 무관하게 고정
FUTURES_VIRTUAL_START_BALANCE = 20000.0
근본적으로는 import * 대신 필요한 값만 골라 가져오는 게 맞지만, 파일을 많이 뜯어고쳐야 해서 우선 위험한 값부터 고정했습니다. 대신 앞으로 단타 쪽에 새 설정을 추가할 때마다 스윙에도 새어 들어가는지 확인해야 한다는 메모를 남겼습니다.
사건 2: 고쳤다고 보고했는데 적용이 안 되고 있었다
선물 봇의 손절폭 설정을 넓히는 작업을 했습니다. 코드의 기본값을 바꾸고, 봇을 재시작하고, “손절폭을 0.6~2.5%로 넓혔다”고 기록해뒀습니다.
며칠 뒤 다른 설정을 검토하다가 봇이 실제로 쓰는 값을 찍어봤는데, 손절폭이 여전히 옛날 값(0.5~1.2%)이었습니다. 며칠 동안 고쳤다고 믿은 채로, 실제로는 옛 설정으로 돌고 있었던 겁니다.
원인은 .env 파일이었습니다. 설정 모듈은 이렇게 생겼습니다.
load_dotenv()
FUTURES_MAX_STOP_PCT = float(os.getenv("FUTURES_MAX_STOP_PCT", "0.025"))
코드의 "0.025"는 .env에 값이 없을 때만 쓰이는 기본값입니다. 그런데 .env에 FUTURES_MAX_STOP_PCT=0.012가 예전부터 들어 있었습니다. 코드를 아무리 고쳐도 .env가 이깁니다.
억울한 점은, 같은 작업에서 레버리지 같은 다른 값들은 .env에 겹치는 키가 없는지 확인했다는 겁니다. 손절폭 세 개만 확인을 빠뜨렸습니다. 그리고 그 .env 파일은 서버의 모든 봇이 함께 쓰는 파일이었습니다.
설정값이 정해지는 순서
두 사건을 겪고 나서 이 서버의 설정 우선순위를 표로 정리했습니다.
| 우선순위 | 출처 | 예 |
|---|---|---|
| 1 (가장 강함) | 프로세스 환경변수 (부모에게서 물려받은 값 포함) | systemd Environment=, 부모 프로세스 |
| 2 | .env 파일 | FUTURES_MAX_STOP_PCT=0.012 |
| 3 | 자기 설정 파일에서 직접 쓴 값 | 스윙의 FUTURES_LEVERAGE = 1.0 |
| 4 | import *로 가져온 다른 파일의 값 | 단타 설정 |
| 5 (가장 약함) | getenv의 기본값 | os.getenv(..., "0.025") |
제가 고친 곳은 가장 약한 5번이었고, 2번이 그걸 덮고 있었습니다.
이후 지키는 확인 방법
- 설정 기본값을 고칠 때는 먼저
grep -n KEY_NAME .env로 덮어쓰는 값이 있는지 봅니다. 있으면 둘 다 고칩니다. - 고친 뒤에는 봇이 실제로 들고 있는 값을 직접 찍어봅니다. 봇이 시작할 때 핵심 설정의 최종값을 로그에 한 줄로 출력하게 해두면 가장 편합니다. 레버리지, 손절폭, 리스크 비율, 모의/실거래 여부 정도면 충분합니다.
- “고쳤다”는 기록은 코드를 바꾼 시점이 아니라 로그에서 새 값을 확인한 시점에 남깁니다.
설정 체계가 여러 겹이면 편리한 만큼 헷갈립니다. 어느 파일을 고쳤는지보다, 프로그램이 최종적으로 어떤 값을 들고 있는지를 확인하는 게 훨씬 확실했습니다.