科技 · 实用指南
Git 提示子模块路径没有 URL？先核对 gitlink 与 .gitmodules，再删除文件
分别检查失败提交、当前索引、版本化映射与本地检出，再选择修复、同步、deinit 或从仓库移除。
WATCH AT EASE · 实用指南
往期报道
已发表的往期报道，保留原始日期。
145–168 / 359
科技 · 实用指南
curl 收到 100 或 103 仍报 Empty reply？检查最终响应
收到响应头不代表请求完整结束。6 组 curl 8.5.0 对照实验区分信息响应、合法空正文与错误 52。
科技 · 实用指南
curl 错误 35：改密码套件前先标出最后成功的 TLS 边界
错误 35 只说明 SSL/TLS 握手失败，并不说明原因。先记录 curl 构建、代理路径和详细序列，再只改变一个边界并复测。
科技 · 实用指南
curl 错误 28：提高时限前先测 DNS、连接、TLS 和首字节
错误 28 只说明触发了超时条件，并不指出等待发生在哪一层。记录 curl 各阶段耗时，只比较一个受控变量，确认慢点后再调整时限。
科技 · 实用指南
SSH 提示“no matching host key type found”？启用旧算法前先证明协商边界
这条错误指向服务器主机密钥协商，不是你的登录密钥。先证明实际端点、指纹和双方算法列表，再把旧算法仅作为精确主机、有人负责且会到期的临时例外。
技术 · 实用指南
终端能运行，systemd 却报 ModuleNotFoundError？先证明解释器与 sys.path
重装任何包之前，先记录服务的解释器、前缀、用户、工作目录和模块搜索路径；只修复一个已被证实的边界，再重复同一导入探针。
科技 · 实用指南
Git 报“RPC failed; curl 92”？改缓冲区前先证明 HTTP/2 故障边界
curl 92 只证明 HTTP/2 流失败，并不证明 Git 需要更大缓冲区。先保留传输不完整线索，每次只比较一个协议或路径变量，保留任何绕行前先验证对象库。
科技 · 实用指南
rsync 提示“file has vanished”？忽略退出码 24 前先证明源端变动
保留全部消失路径，确认由哪个进程创建或删除，再对同一源或稳定快照复跑；只有明确的临时文件策略才可把 24 降级。
科技 · 实用指南
Docker 守护进程套接字“权限被拒绝”？先证明客户端、套接字与守护进程环境
不要把 docker.sock 设为 666 或 777。先固定客户端身份、Docker context 与准确套接字，区分 rootful、rootless 和容器挂载场景，再只授权需要的主体。
科技 · 实用指南
SSH 提示“Permission denied (publickey)”？复制新密钥前先证明实际提交的指纹
先打印有效目标，抓取客户端实际提交的密钥指纹，再映射到目标账户并检查服务器拒绝证据；不要先改权限或策略。
科技 · 实用指南
curl 错误 6“无法解析主机”？先证明主机名与运行环境，再改 DNS
退出码 6 不能指出故障归属。保留原始 URL，确认 curl 实际解析的主机名，并在失败进程使用的解析器、代理和网络命名空间内复现。
技术 · 实用指南
Python 出现 charmap UnicodeEncodeError？先审计输出接收端
在强制 UTF-8、改变全局模式或丢弃字符前，先证明究竟是哪个写入器、目标与消费者选择了编码。
科技 · 实用指南
PostgreSQL 提示“remaining connection slots are reserved”？杀会话前先建所有者账本
先证明普通用户连接预算，再按应用与年龄归组、冻结新增连接，只结束已确认的陈旧所有者或调整连接池；不要先提高 max_connections。
科技 · 实用指南
Git 提示 dubious ownership？先证明用户、路径所有者与信任作用域
不要直接设置 safe.directory=*；先审计实际 Git、系统身份、仓库真实路径与受保护配置，再做最小修复。
科技 · 实用指南
PostgreSQL SQLSTATE 40001？应重试整个事务，而不是失败语句
记录 SQLSTATE、隔离级别与失败边界；回滚后在有限重试循环中重新执行全部读取和决策，并把不可逆副作用放到提交之后。
科技 · 实用指南
kubectl port-forward 报“connection refused”？重试前审计四个链路
区分本地监听、API 隧道、实际选中的 Pod 和 Pod 内进程；第一个失败点决定该改本地端口、RBAC、目标身份还是应用监听。
科技 · 实用指南
Git push 因 non-fast-forward 被拒？修复前先证明远端引用
拒绝是图结构安全信号，不是要求强推。先确定目标引用与当前 OID，再抓取审计副本，最后选择合并、变基或经批准的明确 lease。
科技 · 实用指南
Gzip 提示“unexpected end of file”？再次解压前先证明字节来源
EOF 可能来自下载截断、流中断，也可能只是把分片误当成完整归档。先保存并验证原始字节，再修复真正失败的传输或拼接环节。