排障手记
简短速记：问题修复、避坑记录与链接精选，来自日常开发的第一手经验。三分钟读完，省一个下午。
本分类共 14 篇文章
-
为什么本地语音合成一直在念 “Percent”？语音管线里的 URL 编码与沙盒避坑记
记录本地部署 CosyVoice 2 并通过群晖 n8n 对接时，语音合成陷入无限重复 “Percent” 的现象剖析，以及字符前端规范化与 n8n 沙盒表达式避坑。
-
我的备份爬得比爬虫还慢，因为我在用别人的 API 配额
1 TB 的 restic 种子传输卡在零字节。日志里点名的那个 Google 项目不是我的：那是 rclone 的共享 OAuth 客户端，配额和全世界每个 rclone 用户共池。
-
NocoDB SSO 是授权功能：环境变量不会告诉你的事
NocoDB 的 OIDC 环境变量是真的，启动时也会校验，所以自托管 SSO 看起来完全受支持。但在未授权的构建上，第一次登录尝试就会让整个实例崩溃。
-
CodeIgniter 4.6 升级到 4.7：官方指南没说到的破坏性变更
CodeIgniter 4.7 官方升级指南列了八项破坏性变更。真正让我应用致命崩溃的那两项不在里面——而且它们属于同一类问题。
-
Apple iCloud 邮箱发信 465 超时：仅支持 587 STARTTLS 的协议陷阱
为什么在自动化邮件客户端中将 Apple iCloud SMTP 设为 465 端口会导致连接超时（WSAETIMEDOUT / os error 10060）？剖析 Apple 邮件网关对 587 端口显式 STARTTLS 的硬性要求。
-
smartctl 退出码 32：专门跳过你最该看的硬盘的那个“错误”
把 smartctl 的任何非零退出码当成读取失败的监控脚本，恰好会跳过属性已经逼近阈值的那些盘。退出码 32 不是错误，而是一段历史。
-
为什么你的 Windows 桌面 MCP 调用会静默失败：攻破 10 秒空闲门禁与避坑实录
排查 windows-mcp 调用返回 CONTROL_PREEMPTED 的深层机制，以及为什么必须通过环境变量彻底禁用桌面控制门禁。
-
NocoDB 附件字段怎么改都不生效，和一个漏网的正则
回填 300 行数据时踩到的两个小坑：NocoDB 在附件保留 id 的情况下会无视 path 的改动，以及一个 lookahead 正则悄悄跳过了没有扩展名的 URL。
-
与其看供应商文档，不如直接读容器自带的 API 文档
当 API 文档藏在登录墙后面、甚至根本不存在时，镜像本身就是唯一的事实来源：四条 Docker 命令，就能挖出 API 规范、配置契约，以及它真正监听的端口。
-
密码正确，Synology API 登录却返回 401，问题出在哪
两种原因，同一个报错：Office Suite API 对 TLS 握手失败和受 2FA 保护的账号返回完全相同的错误。三条命令就能在一分钟内精准区分，省去一下午的盲目排查。
