같은 이름의 def가 두 개 있었고, 뒤의 것이 이겼다 초안

처리 중 문제가 생겼어요

2026년 10월 말, 검색 명령 두 개가 실행하자마자 이 문구로 끝났다. 봇의 공통 오류 응답이다. 안에서 난 것은 TypeError였다.

검색 명령 두 개가 공통으로 부르는 async def _find(update, context, kind)를 새로 만든 참이었다. 그런데 같은 파일 1,200줄 근처에 전혀 다른 용도의 def _find(rows, target)이 이미 있었다. 새 함수는 파일 위쪽, 옛 함수는 아래쪽이었다. 모듈 로드가 끝난 시점에 _find는 옛 함수였고, 명령 핸들러가 인자 세 개로 부르자 인자 두 개짜리 함수가 받았다.

파이썬에서 def는 실행문이다. 모듈이 로드될 때 위에서 아래로 실행되면서 def name(...)을 만날 때마다 함수 객체를 만들어 name에 대입한다. 같은 이름의 def가 두 번 나오면 두 번째 대입이 첫 번째를 덮는다. 경고는 없다.

def find(a, b, c):
    return "new"

def find(rows, target):      # 아무 경고 없이 위의 것을 덮는다
    return "old"

find(1, 2, 3)                # TypeError: 인자 개수가 맞지 않는다

새 쪽의 이름을 더 구체적으로 바꿔서 고쳤다.

커뮤니티용 텔레그램 봇의 코드에는 1,000줄이 넘는 파이썬 모듈이 몇 개 있다. _find 같은 짧은 private 이름은 파일이 작을 때는 충분하지만 이 크기에서는 누군가 이미 썼을 가능성이 높고, 새 함수를 쓰는 사람은 파일 전체를 읽지 않는다. 이번이 처음도 아니었다. 9월 말부터 10월 말까지 한 달 동안 이름과 호출 배선에서 비롯된 버그를 네 번 고쳤는데, 네 건 모두 문법 오류가 아니었고 import도 성공했다. 그중 두 건이 같은 이름의 함수 두 개였다.

10월 초에는 예외도 나지 않았다

맥에서 도는 자동화 스크립트의 화면 잠김 판정이 실제로 잠긴 화면에서도 False였다.

150줄 근처에 ioreg 출력으로 잠김을 판정하는 screen_locked를 새로 넣었는데, 1,760줄 근처에 두 달 전에 만든 같은 이름의 함수가 남아 있었다. 옛 함수는 다른 방식으로 판정했고 잠긴 화면에서도 False를 돌려줬다. 두 함수의 시그니처가 같아서 호출은 성공했고, 틀린 답이 조용히 돌아왔다. 로그에는 “잠김”이 “꺼짐”으로 적혔다. 화면을 깨우기만 하면 풀리는 문제처럼 보였다.

옛 정의를 지웠다.

검색 명령 건과 나란히 놓으면, 시그니처가 다를 때는 TypeError로 바로 드러나고 같을 때는 동작만 달라진 채로 계속 돈다. 뒤쪽이 더 나쁘다.

이쪽에는 소스 파일을 텍스트로 읽어 정의 개수를 세는 검사를 붙였다.

src = open(REC, encoding="utf-8").read()
n = src.count("\ndef screen_locked(")
check("screen_locked 정의는 하나뿐 (뒤 정의가 앞을 덮던 버그)", n == 1, str(n))

투박하지만 정확히 이 버그를 막는다. 함수를 import해서 호출하는 테스트로는 두 개 중 어느 것이 살아남았는지만 알 수 있고, 두 개라는 사실은 알 수 없다. 같은 테스트에서 ioreg 출력을 흉내 낸 입력으로 잠김과 안 잠김이 제대로 갈리는지도 함께 확인한다.

같은 날, 렌더러는 옳았고 부르는 쪽이 틀렸다

10월 초의 같은 날, 목록을 보여 주는 명령 하나도 TypeError로 죽었다. 덮어쓰기는 아니지만 같은 계열이다.

목록 명령 여러 개가 공용 래퍼를 거치고, 래퍼는 데이터를 가져온 뒤 렌더러를 이렇게 부른다.

text = render(*data, today)

조회 결과를 풀어서 넘기고 마지막에 오늘 날짜를 붙인다. 그런데 한 명령의 데이터 조회가 두 개짜리 튜플 (rows, extra)를 돌려주게 바뀌었다. 그 명령의 렌더러 시그니처는 (rows, today, extra)였으므로, 풀어서 넘기면 today 자리에 extra가, extra 자리에 날짜가 들어갔다.

순서를 맞추는 lambda 한 줄로 고쳤다.

await _list_command(
    update, context,
    lambda rows, extra, today: render_list(rows, today, extra),
    _fetch_sync,
)

테스트가 있었는데도 잡히지 않았다. 테스트가 렌더러만 직접 불렀기 때문이다.

그래서 렌더러만 부르던 기존 검사 옆에 명령 핸들러부터 시작하는 검사를 추가했다. 권한 확인, 데이터 조회, 응답 전송 세 곳을 가짜로 바꿔 끼우고 핸들러를 실행한 뒤 전송된 텍스트를 본다.

sent: list[str] = []
M._gate = lambda u: (SimpleNamespace(), None)
M._fetch_sync = lambda: (ROWS, EXTRA)

async def _fake_reply(context, route, message, text):
    sent.append(text)
M._reply = _fake_reply

asyncio.run(M.cmd_list(None, None))
check("명령 경로가 추가 목록째 그린다", len(sent) == 1)

9월 말, 메뉴만 예전 것으로 남아 있었다

네 건 중 처음이자 가장 단순한 건이다. 봇이 기동할 때 명령 메뉴 등록이 NameError로 통째 실패했다.

메뉴를 설치하는 함수에서 변수 이름을 바꾸면서 함수 아래쪽 루프에 있던 참조 하나를 고치지 않았다. 파이썬은 함수 본문의 이름을 실행할 때 찾으므로 import는 성공하고, 그 줄에 도달했을 때에야 NameError가 난다. 그 줄은 기동할 때 한 번만 실행되는 메뉴 등록 경로에 있었다.

메뉴 등록은 명령 처리와 분리돼 있다. 등록이 실패해도 명령은 동작하니 봇은 정상으로 보였고, 사용자에게 보이는 메뉴만 예전 상태로 남아 있었다.

여기에는 set_my_commands 호출을 기록만 하는 가짜 봇을 만들어 설치 함수를 처음부터 끝까지 실행하는 테스트를 붙였다. 검증 내용보다 끝까지 돈다는 것 자체가 중요하다. NameError는 그 줄을 실행하기만 하면 드러난다.

class _Bot:
    def __init__(self):
        self.calls = {}

    async def set_my_commands(self, cmds, scope=None):
        self.calls[getattr(scope, "chat_id", None)] = [c.command for c in cmds]

app = _App()                                   # bot = _Bot()
asyncio.run(menu.install_scoped_menu(app))     # 끝까지 돌아야 한다

코드 수정은 네 건 전부 한두 줄이었다. 시간을 들인 쪽은 테스트다.

F811이 잡아 주는지는 확인하지 않았다

함수 재정의는 린터가 겨냥하는 종류의 문제다. pyflakes와 ruff에는 재정의를 경고하는 규칙(F811 계열)이 있다. 다만 이 저장소에서 그 규칙을 CI에 걸었다는 기록은 없고, 위의 두 건을 그 규칙이 실제로 잡아 주는지도 확인하지 않았다. 지금 이 버그를 막고 있는 것은 위의 테스트들이다.