拾光匠记

记录技术、生活和思考。用文字沉淀知识,用分享连接世界。

最新文章

  • 变更窗口撞车之后:一次冲突识别与协调的复盘 随笔

    2026年10月17日,某SaaS企业订单域数据库升级与营销域优惠券配置发布落在同一变更窗口,导致订单创建失败率升至11%,业务中断27分钟。复盘认为根因不是执行失误,而是排期阶段缺少依赖关系与资源占用的共同视图。团队随后通过依赖图谱、资源级冲突检查、单一事故指挥、可逆优先回滚、无责但有边界的复盘及冲突识别提前量等指标,推动变更管理从单票审批转向跨域协同。

  • 事故响应值班交接:一张模板打通信息同步 随笔

    本文实测了一套「事故响应值班交接单」模板:在约40人值班组连续使用30天,覆盖12次交接和6起P2/P3事件,平均交接时长从18分钟降至9分钟,接班后重复追问减少约六成。作者给出8.7/10,建议跨班、跨团队、跨时区及长周期事件纳入标准流程,小团队用9字段精简版即可,核心是让下一班3分钟内知道现状、待办和下一步检查点。

  • 凌晨三点的缓存雪崩,教会我给系统留后路 随笔

    文章复盘凌晨三点缓存雪崩:大量热点键同时过期叠加重试风暴,请求穿透缓存打爆数据库。作者由此反思,系统不能假设缓存永远可用,必须为依赖失效预留有边界的后路:TTL加随机抖动、请求合并与单飞、多层缓存、降级开关代码化,并通过演练和观测验证。核心观点是:成熟系统不仅要跑得快,更要在最坏时退得稳。

  • 第三方SDK升级:兼容性验证的踩坑与复盘 随笔

    文章复盘某千万级月活App支付、推送、地图、统计四类第三方SDK跨大版本升级中的九类兼容性踩坑,包括冷启动白屏、设备与ABI矩阵过窄、隐私初始化越界、线程依赖冲突、灰度只看崩溃率、回滚数据格式不兼容、测试环境与线上差异、资源冲突与包体膨胀、多进程/WebView/后台限制遗漏。团队据此建立四层兼容性验证漏斗、风险用例清单,以及SDK准入卡、设备矩阵、启动基线、合规自动化、初始化编排器、灰度双指标门禁和季度回滚演练,将验证周期从平均3天缩短到1.8天,回滚耗时从52分钟降到18分钟。

  • 发布检查单:别让配置与数据变更成为漏网之鱼 随笔

    配置与数据变更必须和代码一样纳入版本、评审、验证与回滚闭环;发布检查单要具体到人、时间、命令和证据,让变更可见、可追溯、可执行,最终目标不是零变更,而是零意外。

  • 缓存先崩了?高并发穿透与雪崩治理手记 随笔

    文章复盘会员商品中心高并发事故:缓存穿透、雪崩与击穿叠加导致Redis和数据库承压。团队按“先挡无效流量、再削回源峰值、最后故障隔离”治理,落地参数校验、布隆过滤器、短TTL空值缓存、逻辑过期异步重建、TTL随机抖动、热点多副本、信号量隔离与熔断降级,并新增回源与热点监控。上线后数据库回源QPS降85%,p99从2.4s降至180ms,错误率从9.2%降至0.02%。

  • 第三方SDK升级:兼容性验证的五个关键步骤 随笔

    第三方SDK升级的关键在于验证旧行为是否仍成立。本文给出五个步骤:建立升级基线与影响面清单,先做静态与契约级兼容检查,搭建分层自动化测试与真实设备矩阵,开展运行时灰度与可观测性验证,并完成合规、安全与供应链复核,将升级纳入治理机制,形成可复现、可度量、可回滚的证据链。

  • 代码评审别只看Bug:12个可维护性检查点 随笔

    代码评审不应只停留在找 Bug,更要评估改动是否让系统长期可理解、可修改、可验证和可回滚。文章提出 12 个可维护性检查点,涵盖命名、职责边界、控制流、重复与抽象时机、错误处理、接口契约、状态管理、测试意图、配置依赖、可观测性、文档决策记录及评审反馈。核心是用品问题替代模糊感觉,既指出未来风险,也给出可执行下一步,并沉淀为团队规则。

  • 配置中心变更演练:让审批有据、回滚有速 随笔

    文章实测了一套配置中心变更演练闭环:变更申请、风险分级审批、灰度发布、运行时观测、一键回滚和演练报告。结论是值得进入生产变更体系,综合评分 8.5/10,尤其适合多环境、多租户、强审计团队。但审批有据依赖配置项治理和依赖关系准确,回滚有速依赖快照、流量切换、缓存与业务副作用预案;配置层回滚快不等于业务恢复快。建议先盘点 P0 配置、绑定审批与发布、验证副作用,并每季度做失败演练,把它当作变更治理系统的一部分,而非免死金牌。

  • 配置悄悄漂移?研发环境发现与治理闭环 随笔

    本文讨论研发环境中配置漂移的发现与治理闭环:漂移源于声明态、发布态、运行态之间缺少一致性校验,且证据分散、例外无生命周期。治理应从状态证据链入手,通过盘点、基线、采集、语义 diff、归因和风险评分识别漂移,再以分级处置、PR 式修复、自动收敛和例外管理完成闭环,并把复发问题反馈到模板、准入策略和 CI 检查。文章强调目标不是零漂移,而是让差异可解释、可处置、可预防,并以组织接口、度量和分阶段路线图保障落地。

  • 索引为何失效?8大典型场景与10步排查清单 数据库

    索引失效通常并非单一原因,而可能来自 SQL 写法、列类型、联合索引顺序、统计信息或优化器成本判断。本文拆解函数包裹、隐式转换、前导通配符、最左前缀不匹配、OR/IN 混合、排序分组不一致、统计信息误判、低选择性或回表成本高等 8 大典型场景,并给出从真实 SQL 与执行计划入手、逐项排查并做对照实验的 10 步清单,强调优化目标是让关键查询稳定、可解释、可回滚,而非盲目追求命中索引。

  • 故障隔离与降级:高可用架构的两道防线 随笔

    本文系统阐述高可用架构中的故障隔离与降级两道防线:隔离通过机房、单元化、资源池和租户边界控制故障爆炸半径,降级在资源不足时有序放弃非核心能力、守住交易登录支付等关键路径。文章强调先隔离后降级,并需配套超时、限流、熔断,形成“观测—决策—执行—恢复”闭环,通过混沌演练验证,最终以爆炸半径、核心可用性、降级覆盖率、MTTD/MTTR等指标验收。

  • 技术选型别只看报价:一套可落地的TCO测算框架 技术

    技术选型常被一张报价单误导:自建成本分散在采购、人力、停机、改造等科目,托管却只体现为账单,两者口径不同。本文分享一套可落地的TCO测算框架:拆成六类科目(资本支出、云资源/许可、人力、迁移改造、运维隐性、风险成本),统一按3年年化与全成本口径,每项给出乐观/中性/悲观区间,再做敏感性分析找出会翻转结论的假设。案例中自建年化141万、托管99万,节省42万,真正大头是人力与风险(占自建41%)。核心结论:报价单永远不是成本,区间比单点更有说服力,敏感性分析才是真正产出;TCO是决策输入而非决策本身。

  • 数据权限申请做减法:最小化授权的设计取舍 随笔

    数据权限申请做减法,不是简单砍审批或扩权限包,而是把“更小、更短、更可解释”的最小化授权变成默认路径:用数据目录和任务型套餐明确边界,按风险分级审批,配合时限授权、自动回收与审计复核闭环,让例外有路径、有责任人、有代价,在安全边界内兼顾业务效率。

  • 让技术决策可追溯:会议纪要归档与检索方法 技术

    本文提出一套让技术决策可追溯的会议纪要归档与检索方法:用“会前明确议题、会中记录事实与结论、会后24小时定稿归档、统一命名与目录、结构化模板、核心元数据、四层检索、季度审计复盘”组成最小闭环,把纪要变成可检索、可复用、可审计的组织资产。文章还给出存储权限与版本底线、衡量指标(及时率、完整率、平均定位时间)、工具自动化建议、常见误区,以及30/60/90天落地计划,强调先跑通最小可用流程再持续迭代。

  • 别让风险登记表变成死文档:更新节奏与责任分配指南 技术

    风险登记表常因更新触发不清、责任泛化、字段过重和与决策脱节而变成死文档。文章建议采用固定节拍加事件触发的双轨更新机制,明确风险负责人、行动负责人、管理员等角色并设置备份;精简字段、优化会议,把每次更新与具体决策和截止日期挂钩,再用陈旧率、负责人覆盖率、行动关闭率等指标季度审计,并配套30天落地清单,使登记表从合规材料变为持续可用的风险雷达。

  • 密钥不该躺在配置文件里:敏感配置治理实战 随笔

    本文提供一套可在一到两周内落地的八步敏感配置治理流程:盘点分级敏感配置、从 Git 历史彻底剥离密钥(先轮换再清洗)、选型密钥后端、统一应用侧配置加载层、用动态凭证替代静态密码、以 OIDC 联邦改造 CI/CD 消灭长期凭证、用 gitleaks 扫描与审计告警防泄漏,以及泄露后三十分钟应急响应。核心观点是:密钥不应写在配置文件里,而应存放在随时可吊销、可审计、可追溯使用记录的地方;治理难点不在技术,而在于把“临时先这样”变成“这次就改掉”。

  • 别再用代码行数考核:工程团队效能度量指标体系 研发效能

    文章主张放弃以代码行数考核工程团队,改用交付流动、质量稳定、开发者体验、系统健康和业务影响五层团队级指标体系;强调速度与稳定成对看、不做个人排名、指标必须指向行动,并给出分阶段落地路线与六个月实践效果。

  • 别让升级打断调用:API版本与兼容性设计指南 随笔

    API升级的真正风险在于调用方能否按原有契约稳定工作。本文从兼容性契约、版本策略、变更分类、弃用迁移、契约测试、灰度发布与治理等方面,给出可落地的API版本与兼容性设计方法,帮助团队在持续演进中避免升级打断调用。

  • 密钥写进配置文件那晚,我通宵重做了配置中心 随笔

    文章从一次密钥被写入配置文件的事故出发,指出配置中心应承载密钥引用、元数据和访问策略,而非明文密钥;真正需要重做的是身份、授权、轮换与审计边界,通过短期凭据、最小权限和自动化轮换构建可审计的信任链。