X-Financial/document/development/2026-07-17/dev-logs/bugs/financial-connector-operational-counting-clock.md

财务连接器运行事件计数与固定时钟偏差

日期：2026-07-17 文档路径：document/development/2026-07-17/dev-logs/bugs/financial-connector-operational-counting-clock.md

修复记录

• 11:39：记录 bug 修复：财务连接器相同载荷的不同运行尝试被永久合并，固定时钟场景的接收时间偏离观测窗口。
  • Git 提交检查：已执行 git fetch --all --prune；upstream origin/main 无新提交；本地 ahead 17 条，包含 242d68c3 feat(approval): add task workflow and waiver decisions、28b834ed fix(approval): replay immutable action responses、4940ebc4 feat(approval): add safe risk disposition workflow、ee88a36b feat(ai): add tenant-safe hierarchical expense learning 等共享工作区既有提交，本次未改写这些提交。
  • 修改：financial_connector_operational_events.py 把规范化 UTC 发生时间纳入运行事实幂等命名空间，使同一 candidate 的补偿重试保持单条、不同 HTTP 尝试分别计数；financial_connector_ingestion.py 让注入的可信 now_epoch 同时驱动接收时间和配置健康时间；financial_connector_observability.py 统一把数据库时间规范为 UTC，避免 SQLite/驱动返回 naive datetime 时窗口结果不稳定。
  • 操作：补充运行事实服务、HTTP 冲突、可信认证归属、敏感原值不落库和 PostgreSQL 并发探针；所有 Python、pytest、Ruff 与迁移操作均在 local-x-financial-linux 容器中执行，PostgreSQL 验证使用新建的一次性 disposable-probe 容器，没有连接项目配置中的外部数据库。
  • 验证：容器内连接器与迁移前置定向 115 passed，全新 PostgreSQL 17 完整迁移循环 51 passed，连接器并发 4 passed，后继 0023 并发 7 passed；相关 Ruff 和 git diff --check 通过。
  • 影响：可观测性不会再把多次真实重放压成一次，也不会因测试/模拟可信时钟与实际系统日期不同而漏掉事件；同一补偿 candidate 仍由数据库唯一约束保证幂等。