Python asyncio 优雅停机卡住：从取消信号被吞到结构化并发治理
适用场景与现象 异步消费者、WebSocket 网关或定时任务服务收到 SIGTERM 后，健康检查已经失败，进程却迟迟不退出，最终被 Kubernetes 在宽限期结束时强制 SIGKILL。常见伴随现象是： 停机日志只出现“开始关闭”，没有“后台任务已结束”； 某个任务仍处于 PENDING，但业务请求已经停止进入
Today
持续记录，慢慢变好
技术笔记、项目复盘、阅读摘录和问题清单。
MySQL 连接池复用后请求行为漂移：会话状态泄漏的排查与复位实践
适用场景与现象 同一个接口在生产环境中偶发出现以下现象：有时写入没有立即提交，有时日期相差 8 小时，有时普通查询突然以更严格的事务隔离级别执行。重启应用后故障暂时消失，单独连接 MySQL 手工执行又无法复现。 这类问题常见于使用连接池的 Web 服务、异步任务和批处理程序。连接池归还的是可复用的物理连接，而 MyS
Kubernetes ConfigMap 已更新，容器仍读旧配置：subPath 挂载的定位与修复
适用场景 应用把 ConfigMap 中的单个配置文件挂载到容器现有目录，例如 /etc/app/app.conf。运维修改了 ConfigMap，kubectl get configmap 显示新值，但运行中的应用始终使用旧配置。本文以一个单副本 Deployment 复现，并给出两种可验证的修复路径。以下命令以 B
Django 新订单偶发查询不到：Celery 任务早于事务提交的排查与修复
Django 新订单偶发“查询不到”：Celery 任务早于事务提交的排查与修复 适用场景与现象 下单接口先写入订单，再让 Celery Worker 发送确认邮件。接口返回成功，Worker 却偶发 Order.DoesNotExist；在管理后台查询，同一订单已经存在。失败多发生在数据库写入较慢、Worker 较空
新增 DNS 记录后仍返回 NXDOMAIN：权威链路与负缓存的排查实践
适用场景 为新接口 api.example.test 添加 A 记录后，监控节点已能解析，部分用户却持续报告“找不到域名”。本文以新建记录为例，区分权威服务器未同步、递归解析器负缓存和终端本地缓存。文中的 example.test、权威服务器和 IP 均为示例，执行前须替换为自己的域名与地址。 现象先分清 DNS 查询
PostgreSQL 插入新数据却主键冲突：从序列漂移到安全校准的排查实践
适用场景 本文适用于 PostgreSQL 表使用 serial、bigserial 或 identity 列生成主键，但执行正常 INSERT 时仍出现主键重复的场景。常见诱因包括数据迁移、手工补数据、COPY 导入、只恢复表数据却漏掉序列状态，或者在不同环境之间合并数据。 典型表结构如下： CREATE TABLE
Kubernetes CronJob 重复执行与漏跑：并发策略、截止时间和幂等治理实践
适用场景 本文适用于在 Kubernetes 中运行数据库备份、账单汇总、定时同步、报表生成等周期任务，并遇到以下问题的团队： 上一次任务尚未结束，下一次任务已经启动，两个 Pod 同时修改同一批数据； 控制面短暂不可用或 CronJob 暂停后恢复，任务突然补跑； 配置了 concurrencyPolicy: For
Go 配置热更新偶发数据竞争：用不可变快照与 atomic.Pointer 安全切换
配置热更新看起来只是“重新读一次文件”，但在高并发服务里，它实际上是一次共享状态切换。如果更新协程直接修改正在被请求协程读取的 map、切片或结构体字段，轻则读到新旧配置拼接出的混合状态，重则触发 concurrent map read and map write，让整个进程退出。 本文以一个会动态调整上游地址和超时时
Prometheus remote_write 延迟持续升高：从队列积压到安全恢复的排查实践
适用场景 本文适用于 Prometheus 通过 remote_write 把指标发送到 Thanos Receive、Grafana Mimir、VictoriaMetrics 或其他远端存储的场景。典型问题是本地抓取仍然正常，Prometheus 查询近期数据也没有明显异常，但远端查询、告警或长期存储中的数据逐渐落
Redis Stream 消息不再推进：从 Pending 积压到故障消费者安全接管
适用场景 本文适用于使用 Redis Stream 消费组承载异步任务、事件通知或轻量消息队列的系统。典型架构是生产者通过 XADD 写入 Stream，多个消费者用 XREADGROUP 拉取消息，业务成功后再执行 XACK。 当某个消费者在处理期间崩溃、被强制重启或网络中断时，已经投递但尚未确认的消息不会重新出现在