fix(events): 撞唯一键是幂等命中,不该刷 WARNING + dump 整条 SQL
## 现象(用户从日志里发现的)
WARNING | 写入账号事件失败(account=60 exchange):
(1062, "Duplicate entry 'official_exchange:elite:60:20260120QYOOB_bag360:...'")
[SQL: INSERT INTO account_events (...) VALUES (...)]
[parameters: {...}]
## 分析:**不是 bug,是幂等机制在工作,但日志级别错了**
`emit()` 刻意**不做预检查**,直接 INSERT,靠 `source_ref` 的唯一索引去重;
撞了就 catch(SAVEPOINT 只回滚这一条)。所以:
- **数据是对的** —— 重复的被挡住,`exchange_events_added` 只计新写入的
- **日志是错的** —— 撞唯一键被当成异常打 WARNING,还把整条 SQL + 参数 dump 出来
而"撞唯一键"在这里是**预期内的正常情况**:一键查询会把斗鱼官方兑换记录补成事件,
同一个账号会被反复查询 —— 第二次开始每条记录都会撞。一次查询能刷几十屏,
既淹掉真日志、又让人以为出事了(用户就是因此来问的)。
## 修法
区分「唯一键冲突」与「真错误」:
- 确认是 **1062**(并带 `Duplicate entry` 字样)→ 降为 **DEBUG**,一句话说明"已存在,跳过"
- 其它完整性错误(如非空约束 1048)→ **仍然是 WARNING**
刻意**不把 IntegrityError 整个静音** —— 那会把真问题一起藏起来。
新增 `_is_duplicate_entry()` 只在两种信号都对上时才降级。
## 测试(+3)
- 重复写入返回 False,且**不产生**任何 "写入账号事件失败" 的 WARNING
(用 loguru 的临时 sink 真的抓日志来断言,不是看代码)
- 重复写入不会写进第二条
- `_is_duplicate_entry` 只认 1062,1048(非空约束)仍然返回 False
This commit is contained in:
@@ -36,6 +36,7 @@ from typing import Any
|
||||
|
||||
from loguru import logger
|
||||
from sqlalchemy import text
|
||||
from sqlalchemy.exc import IntegrityError
|
||||
from sqlalchemy.orm import Session
|
||||
|
||||
# ── 事件类型 ──────────────────────────────────────────────
|
||||
@@ -74,6 +75,18 @@ CATEGORY_BUSINESS = "business" # 充值 / 兑换 / 积分 / 开通
|
||||
CATEGORY_OPS = "ops" # 人工操作(分配 / 标签 / 停用)
|
||||
|
||||
|
||||
def _is_duplicate_entry(exc: BaseException) -> bool:
|
||||
"""是否 MySQL 唯一键冲突(1062)。
|
||||
|
||||
只有**确认**是撞唯一键才降级成 DEBUG;其它完整性错误(例如非空约束)
|
||||
仍然是真问题,必须继续 WARNING —— 别把真错误一起静音了。
|
||||
"""
|
||||
code = getattr(getattr(exc, "orig", None), "args", None)
|
||||
if code and code[0] == 1062:
|
||||
return True
|
||||
return "Duplicate entry" in str(exc)
|
||||
|
||||
|
||||
def to_naive_utc(value: datetime) -> datetime:
|
||||
"""把时间归一成 **naive UTC**(本服务所有时间列的落库形态)。
|
||||
|
||||
@@ -208,6 +221,22 @@ def emit(
|
||||
with db.begin_nested():
|
||||
db.execute(_INSERT_SQL, params)
|
||||
return True
|
||||
except IntegrityError as exc:
|
||||
# 撞唯一键 = **幂等命中**,是预期内的正常情况,不是故障。
|
||||
#
|
||||
# 典型场景:一键查询会把斗鱼官方兑换记录补成事件,而同一个账号会被
|
||||
# 反复查询 —— 第二次开始每一条记录都会撞 source_ref。
|
||||
# 以前这里打 WARNING 并把**整条 SQL + 参数**dump 出来,
|
||||
# 一次查询就能刷几十屏,既淹掉真日志、又让人以为出错了(用户报过)。
|
||||
# 所以降成 DEBUG:重复是设计的一部分。
|
||||
if _is_duplicate_entry(exc):
|
||||
logger.debug(
|
||||
f"账号事件已存在,跳过(account={account_id} {event_type} "
|
||||
f"source_ref={source_ref})"
|
||||
)
|
||||
return False
|
||||
logger.warning(f"写入账号事件失败(account={account_id} {event_type}):{exc}")
|
||||
return False
|
||||
except Exception as exc: # noqa: BLE001 - 旁路,任何失败都不上抛
|
||||
logger.warning(f"写入账号事件失败(account={account_id} {event_type}):{exc}")
|
||||
return False
|
||||
|
||||
Reference in New Issue
Block a user