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:
yml2213
2026-10-04 20:35:24 +08:00
parent b199428619
commit 631e33a4f6
2 changed files with 119 additions and 0 deletions
@@ -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