Debug Report: 쿠폰 없는 주문에 할인이 붙는 문제
원인
coupons.py의 apply_coupons(order, subtotal, applied=[])에 있던 가변 기본 인자가 원인입니다.
- 파이썬은 기본값
[]를 함수를 정의할 때 한 번만 만들고, 이후 모든 호출이 같은 리스트를 씁니다. - 한 주문에서 쿠폰을 쓰면 그 코드가 리스트에 남습니다.
- 이후 모든 주문에 그 쿠폰이 자동으로 적용됐습니다.
- 서버를 재시작하면 리스트가 비워지므로, 재시작 직후 몇 건만 정상으로 보였습니다.
로그와 일치하는 부분은 다음과 같습니다.
- #1042, 18:22: WELCOME10을 쓴 뒤 이후 주문이 전부 10% 할인됐습니다. #1043, #1044가 해당합니다.
- #1045, 19:15: BREAD2000을 쓰자 WELCOME10과 합쳐서 4,000원이 깎였고, 그 뒤로도 계속 이어졌습니다.
- 재시작 후 #1047, #1048: 정상이었습니다.
- #1049, 19:58: BREAD2000이 다시 쌓이기 시작했습니다.
- #1050 이후: 한 번 더 누적되어 WELCOME10 + BREAD2000이 함께 적용됐습니다.
단톡방에서 짐작한 "배달비 기준 변경" 때문이 아닙니다. 배달비 계산은 모두 정상이었습니다. "2만원대 주문이 이상하다"는 것도 쿠폰이 누적된 우연이었습니다.
테스트가 통과한 이유는 쿠폰 쓴 주문을 2건 이상 연달아 처리하는 테스트가 없었기 때문입니다.
수정
applied를 함수 안에서 주문마다 새로 만들도록 바꿨습니다(coupons.py).- 같은 주문 안에서 같은 쿠폰을 두 번 쓰면 한 번만 적용되는 기존 동작은 유지했습니다.
- 회귀 테스트 2개를 추가했습니다(
tests/test_pricing.py). 테스트 5개가 모두 통과했습니다. - 어제 주문 내역을 새 코드로 다시 계산해 보니, 쿠폰을 쓴 주문만 할인되고 나머지는 정상으로 나왔습니다.
결제 금액이 틀렸던 주문 (잘못 찍힌 금액 → 맞는 금액)
| 주문 | 손님 | 기록된 결제 | 맞는 결제 | 차액 |
|---|---|---|---|---|
| #1043 | 박○○ | 18,300 | 20,000 | 1,700 덜 받음 |
| #1044 | 최○○ | 28,800 | 32,000 | 3,200 덜 받음 |
| #1045 | 정○○ | 19,000 | 21,000 | 2,000 덜 받음 |
| #1046 | 강○○ | 10,900 | 14,000 | 3,100 덜 받음 |
| #1050 | 한○○ | 17,200 | 19,200 | 2,000 덜 받음 |
| #1051 | 오○○ | 14,500 | 18,000 | 3,500 덜 받음 |
| #1052 | 서○○ | 32,200 | 38,000 | 5,800 덜 받음 |
나머지 #1041, #1042, #1047, #1048, #1049는 정상이었습니다. 손님이 7분이고, 모두 실제보다 적게 청구됐습니다. 합계 21,300원입니다.
확인이 필요한 부분
- 이미 결제된 건의 처리: 추가 청구할지, 서비스로 처리할지는 사장님이 정할 일입니다. 제가 정할 수 없어서 차액만 정리했습니다.
- 어제 18시 이후 다른 주문: 제가 본 파일은 #1041~#1052뿐입니다. 그 이후 주문이 있으면 같은 방식으로 다시 계산해 확인해야 합니다.
- 무료 배달 기준: 지금은 할인 전 상품합계로 판단합니다. 예를 들어 32,000원 주문에서 BREAD2000을 쓰면 결제액이 30,000원 아래로 내려가도 배달은 무료입니다. 이 기준은 원래 의도일 수 있어서 그대로 두었습니다. 할인 후 금액으로 판단하려는 것이었다면 알려 주세요.
- 서버 재시작: 수정한 코드를 반영하려면 서버를 한 번 재시작해야 합니다.
재발 방지
- 쿠폰 코드를 쓰는 연속 주문 테스트를 추가했습니다.
- 배포 때는 "테스트 통과"만 보지 말고, 쿠폰 쓴 주문 다음에 쿠폰 없는 주문이 들어오는 경우도 직접 확인하세요.
- 함수 기본 인자에
[]나{}를 쓰지 않는 것을 코드 리뷰 기준으로 삼으면 같은 문제를 막을 수 있습니다.
클로드가 고친 코드 (원본과 비교)
diff -ru -x __pycache__ -x *.bak* -x *backup* base/coupons.py runs/skill-2/coupons.py
--- base/coupons.py 2026-11-22 10:40:56
+++ runs/skill-2/coupons.py 2026-11-22 10:43:26
@@ -4,8 +4,9 @@
"WELCOME10": ("rate", 0.10), # 첫 주문 10% 할인 (11-21 추가)
}
-def apply_coupons(order, subtotal, applied=[]):
+def apply_coupons(order, subtotal):
"""주문에 붙은 쿠폰을 확인하고 할인 금액을 돌려준다."""
+ applied = [] # 주문마다 새로 만든다 (기본 인자로 두면 주문 사이에 쿠폰이 누적됨)
for code in order.get("coupons", []):
if code in COUPONS and code not in applied:
applied.append(code)
diff -ru -x __pycache__ -x *.bak* -x *backup* base/tests/test_pricing.py runs/skill-2/tests/test_pricing.py
--- base/tests/test_pricing.py 2026-11-22 10:40:56
+++ runs/skill-2/tests/test_pricing.py 2026-11-22 10:43:28
@@ -15,5 +15,15 @@
r = order_total({"items": [{"price": 20000, "qty": 1}], "coupons": ["WELCOME10"]})
self.assertEqual(r["total"], 21000)
+ def test_d_coupon_does_not_leak_to_next_order(self):
+ order_total({"items": [{"price": 20000, "qty": 1}], "coupons": ["WELCOME10", "BREAD2000"]})
+ r = order_total({"items": [{"price": 17000, "qty": 1}], "coupons": []})
+ self.assertEqual(r["discount"], 0)
+ self.assertEqual(r["total"], 20000)
+
+ def test_e_same_coupon_twice_in_one_order(self):
+ r = order_total({"items": [{"price": 20000, "qty": 1}], "coupons": ["BREAD2000", "BREAD2000"]})
+ self.assertEqual(r["discount"], 2000)
+
if __name__ == "__main__":
unittest.main()