Python 请求参数串数据：可变默认值与浅拷贝的定位和修复
一个报表接口连续执行两次：第一次查询订单，第二次查询库存。库存请求却带上了订单请求追加的字段。重启进程后暂时恢复，压测时又复现。数据库查询本身没有问题，污染发生在构造查询参数之前。 这类故障不一定需要并发：同一进程中两个顺序调用就能触发。本文用纯 Python 标准库复现并修复，适用于长期运行的 Web 服务、任务 W
Tag
#开发
包含这个标签的文章。
Python CSV 导入静默丢列：重复表头、BOM 与行宽异常的定位和修复
库存调整 CSV 看起来有三列，导入后却只剩两个字段；另一份文件的 sku 明明存在，程序却报 KeyError。这类问题先查文件边界，别急着给字典取值加默认值。默认值会把格式错误变成库存错误。 本文约定一个具体接口：上传 UTF-8 的 CSV，列为 sku,quantity,note，SKU 只能包含大写字母、数字
Python 金额差一分钱：从 float 输入污染到 Decimal 舍入边界
场景：计算结果没报错，核对总额却对不上 订单预览、费用计算和导出报表里，容易出现两种相似的现象：2.675 保留两位变成 2.67；两条 0.335 的明细分别显示 0.34，总计却显示 0.67。前者可能是输入已经经过二进制浮点数，后者可能是逐行舍入与汇总舍入的口径不同。只把所有变量换成 Decimal，解决不了第二
PostgreSQL 报表金额翻倍：一对多关联放大聚合的定位与修复
订单明细增加退款展示后，报表的销售额突然变大。单独查订单金额正确，单独查退款也正确，只有合并查询对不上。此时先检查关联后的数据粒度：一张订单同时对应多条商品明细和多条退款时，两组明细会组合成多行，最后的 SUM 会把同一金额累计多次。 本文以 PostgreSQL 17 为语义基准，用一套可复现数据定位问题，再把查询改
Python 日志一条变两条：从 handler 重复注册到传播链修复
适用场景与现象 适用于 Python 3.10 及以上的命令行程序、后台任务和自有服务。业务代码只调用一次 logger.info()，同一进程的原始输出却出现两行；或者应用工厂每执行一次，同一事件就多输出一遍。 先分清重复发生在哪一层：若进程的 stderr 只有一条，而日志平台出现两条，优先检查采集路径是否同时包含
PostgreSQL 排除查询突然返回零行：NOT IN 遇到 NULL 的定位与修复
场景：有待处理订单，补偿任务却扫不到 补偿任务从订单表里找出“尚未有成功回执”的订单。原先使用 NOT IN (SELECT order_id ...)，导入一条未关联订单的回执后，任务突然返回零行，接口没有报错，查询耗时也正常。 下面是隔离复现，不代表真实生产事故。SQL 按 PostgreSQL 17 编写，使用会
Python 解压不可信 ZIP：同时防住路径穿越、符号链接与解压炸弹
适用场景 本文适用于允许用户上传 ZIP 的报表导入、主题包安装、批量图片处理和离线数据交换服务。压缩包来自外部时，风险不只是文件名中出现 ../：绝对路径、Windows 盘符、反斜杠、同名覆盖、Unix 符号链接以及极高压缩比，都可能让一次普通解压变成任意文件写入或磁盘耗尽。 目标是建立一个可验收的解压边界：先检查
Python 调用遗留命令乱码又卡死：字节解码、超时与安全参数实践
适用场景 本文适用于 Python 3.11 及以上版本。业务程序需要调用数据库备份工具、硬件厂商 CLI、Windows 遗留程序或内部运维命令，但这些程序的输出编码不是 UTF-8，并且可能出现长时间无响应、非零退出、输出管道堵塞或参数注入风险。 目标不是再封装一层 subprocess.run()，而是建立一个可
HTTPX 流式响应偶发 PoolTimeout：从连接未释放到生命周期闭环
Python 服务用 HTTPX 转发大文件、对象存储下载或上游 SSE 时，通常会启用流式响应，避免把整个响应体读入内存。上线后却可能出现一种很迷惑的故障：服务启动时一切正常，运行一段时间后请求开始批量报 httpx.PoolTimeout；重启进程能暂时恢复，单纯调大连接池只能延后复发。 这类问题往往不是上游连接慢
Go OAuth 令牌过期瞬间请求雪崩：用 singleflight 合并刷新并隔离超时
调用第三方 API 的 Go 服务通常会在内存中缓存 OAuth 访问令牌，并在令牌即将过期时刷新。单实例、低并发时，这段逻辑看起来很简单；并发升高后，几十个请求可能同时发现令牌失效，又同时访问认证端点。结果不是更快拿到新令牌，而是认证服务返回 429 Too Many Requests，业务请求批量失败，甚至出现“较