换到流萤主题后，代码块里多出两种颜色：每行有字的地方垫着一块底色，折叠时底部渐隐和「展开全部」条偏蓝。原因都是组件底座写死了藏青色，而主题的代码底色换了。本文记录排查和修法：行内元素的背景为什么一行一画；想保留渐隐曲线只换颜色时用 color-mix，以及带 var() 的 color-mix 在旧浏览器里会整条失效、兜底必须写在后面的 @supports 里；用自写 PNG 解码逐像素比较，证明其它主题一个像素都没变；Playwright 定位器重新查询造成的假「点了没反应」；AI 助手黑夜里的同类问题。
博客文章页的分享海报重做了一遍：加上封面、分类、标签和头像，弹窗改成一屏放下。本文记录重做时量出来的几个问题：旧版逐字换行，全站 372 篇文章里有 288 篇的海报把英文单词拆开、把标点放在行首；canvas 画了跨域图片就会被污染、无法导出，七牛的图要服务器允许跨域、页面设置 crossOrigin 才能画，而 Chrome 还会为这类请求单独建连接；二维码先画成小图再放大，边缘有三成是灰色的过渡像素。以及对应的断行规则、图片加载策略和按屏幕尺寸计算海报大小的写法。
博客默认主题换成流萤后，用无头 Chrome 在手机尺寸下做冷加载实测：首页 1495 KB 里有 849 KB 是一个字体文件，页面上却没有一个字用它。本文记录这一轮排查：预加载让按需下载的字体变成必下，CSS 背景图当最大内容时浏览器发现得太晚，评论照片显示 220px 却下载 1080px，改 srcset 时撞上同一段 HTML 被规范化两遍，以及打字机副标题折行导致的首屏跳动。改完四个页面的冷加载流量减少 42% 到 68%。
给博客的手机菜单做右侧抽屉时，一个 position: fixed、top 和 bottom 都是 0 的抽屉，只要写在顶栏里面就只有 64px 高，顶栏向上收起时还会被一起带走——毛玻璃用的 backdrop-filter 让顶栏成了它的包含块。本文先说明 fixed 元素的包含块什么时候不再是视口，再用 Chrome 154 实测 20 种写法：transform、translate、filter、backdrop-filter、perspective、will-change: transform、contain、content-visibility 会“截胡”，opacity、isolation、mix-blend-mode、z-index、container-type 只建立层叠上下文、不会截胡；全站置灰的滤镜放在 html 上安全，放在 body 上会让所有 fixed 元素跟着页面滚走。最后给出用 offsetParent 一行找到“截胡者”的排查方法，以及挪出 DOM、把属性挪到伪元素上两种修法。
博客在六天里从一套样式变成了六套主题。第一版只叠了一张 1528 行的覆盖样式表，颜色换了、骨架没变，第二天推倒重来：每套主题一套独立模板，评论、表情、AI 助手等组件抽成共享片段，脚本一行不改。本文记录这套结构的划分与回退机制、Thymeleaf 片段选择器和 CSS 层叠带来的几个坑、去掉点击后的焦点框时要对付的 120 条规则，明暗切换的圆形扩散为什么在流萤上看不出来、又为什么一顿一顿，用无头 Chrome 做流畅度测试找到的几处主线程空转，以及不部署就在线上页面验证本地样式的方法。
发版时偶发的 502 往往不是代码抛出的，而是停机链条上某个环节没有接上。本文用 Spring Boot 2.7 与 Tomcat 9 做对照实验，以 SIGTERM 为零点记录进行中的请求、新连接、keep-alive 连接和 SSE 的实际表现，说明优雅停机只保护已进入应用的请求；再依次排查启动脚本缺少 exec 导致 JVM 收不到信号、timeout-per-shutdown-phase 并非硬上限、Kubernetes preStop 与宽限期的预算，以及 Nginx 对 GET 与 POST 重试行为的差异，最后给出长连接收尾、线程池等待和发版期间的验证方法。
Prometheus内存上涨、抓取变慢、看板超时，未必是业务流量增加，也可能是指标标签失控。用户编号、原始请求路径和请求标识一旦进入标签，少量埋点就可能扩展成大量时间序列。围绕高基数与序列抖动，拆解经典直方图的放大效应，结合 TSDB 统计、PromQL 和抓取指标定位问题，再通过定向丢弃、源头归一化、Micrometer 标签限制与回归测试建立治理闭环，同时说明删除标签、延长抓取周期和预聚合为什么不能替代正确的指标设计。
本文根据两个仓库共 703 条 Git 提交整理，记录这个博客从 2023 年 1 月第一次进入 Git 到 2026 年 9 月的完整演进：2023 年从零到可用；2024 年补齐七牛封面、登录封禁、评论审核与缓存；2025 年围绕评论系统深度重构；2026 年上半年引入 AI 问答与 AI 评论审核；7 月并入 total 聚合工程后，又经历了界面重做、自托管字体与图表、评论 AI 容错，以及 9 月一轮集中的性能、可靠性与细节治理。
S3 文件上传成功后，ETag 与本地 MD5 不一致，并不必然意味着文件损坏。本文从单次上传、服务端加密与分段上传的差异出发，解释传统 Multipart ETag、整文件摘要和组合校验和的边界，并通过可运行的 Python 实验验证分段方式对结果的影响。随后给出 AWS CLI 上传、对象版本绑定、云端校验和读取与下载验证流程，梳理 Base64 编码、源文件变化、权限不足和合并响应处理等陷阱，帮助建立可追踪、可排障的文件完整性验证机制。
一台 2 核 1.7 GB、出口约 4 Mbps 的服务器上跑着六个 Spring Boot 应用。本文记录一次先测量、后动手的全面体检：证书自动续期与每日备份，用 rsync 加可复现构建把发版上传从 50 分钟压到十几秒，把占文章页 85% 的内联脚本逐字节核对后外置，第三方前端库改用固定版本副本，归档页从 260 毫秒降到 40 毫秒，修正软 404 与扫描器噪音，并记录音乐版权误判的真实原因，以及测完内存数据后决定不做的取舍。
