一项原本验证进程间通信的测试，在本机巡检中先报“等待服务就绪超时”。直觉容易把它归因于服务启动慢、连接失败，甚至直接重启服务。但把失败向前追一层，服务端根本没有成功创建监听端点：Unix 域套接字的地址路径过长，错误发生在测试初始化的 bind()，不是业务通信阶段。
这次案例值得单独说，因为“临时目录越隔离越安全”和“套接字路径可以任意拼接”并不能同时成立。修正测试后，通信仍然走真实套接字，而不是把关键行为改成 mock。
先定位第一个失败，不要被最后的超时带走
测试的流程很简单：在隔离临时目录里创建一个套接字，启动一个只接收一次连接的小服务端；主线程等它宣布就绪，再发请求并断言返回数据。原写法类似：
socket_path = tmp_path / "probe.sock"
server.bind(str(socket_path))
ready.set()
当测试根目录已经包含多层运行缓存、用户名、测试名及编号时，最终地址不仅有短短的 probe.sock，还会带着整个绝对路径。现场的第一处异常是服务端 bind() 报路径过长；因为它没走到 ready.set()，主线程才随后等到超时。若只看末尾断言，就会把“没有监听成功”误写成“服务响应太慢”。
Linux 的 unix(7) 手册说明，sockaddr_un.sun_path 在 Linux 上是一个固定大小的路径字段，路径名及终止字节须在该字段的容量之内；它还提醒不同实现的字段容量可能更短。[1] 所以这里不是普通文件系统允许的路径长度，也不应把某台机器上的可用长度写成跨平台常数。特别是中文目录名，要按实际编码字节而非“字符数”理解约束。
修正测试的地址表示，不撤掉真实通信
这轮修正只改了测试的地址构造：仍使用测试框架为本用例创建的隔离目录，但先切换当前工作目录，再传入短相对路径。
monkeypatch.chdir(tmp_path)
socket_path = Path("probe.sock")
server.bind(str(socket_path))
套接字仍落在该隔离目录里；传给 Unix 套接字 API 的却只是短地址。于是测试继续完整经过创建监听、请求、响应和断言，缺失服务与异常协议的相邻用例也没有被跳过。候选修改只触及这一处测试，在隔离验证中，相关测试全部通过；但它尚未合入现行巡检，因此不能宣称生产服务已修好或原巡检已经恢复。
另一个可选做法是把临时套接字目录设在受控、权限合适的短路径下，但必须保留用例隔离、冲突处理和清理合同。不能为了缩短路径，把套接字直接丢进共享目录；也不能用 mock 替代真实连接后，继续声称验证了通信协议。
这种修法有自己的边界
- 只针对路径长度诱发的初始化失败。 如果服务端确实完成
bind()并宣布就绪，之后请求还失败，应另查权限、协议、超时与客户端连接路径。 - 切换工作目录是进程级状态。 对同一进程内并发运行、依赖相对路径的测试，不应不加约束地照搬；可以改用专门的短目录或隔离进程。
- 不能从候选测试通过推断服务整体健康。 本轮证明的是这个测试故障可复现、窄修正可以穿过真实通信；是否进入主分支以及原巡检是否转绿，要以合入后的同入口复验为准。
给下次排障留一个可执行顺序
- 找到第一条异常以及发生的系统调用，不从最后一个 timeout 倒推根因。
- 打印或检查传给
bind()的完整路径；有路径错误时先估算编码后字节数，并核对目标系统的套接字地址约束。 - 保留隔离目录与真实连接，只缩短套接字地址；再跑通信、异常输入及服务缺失的相邻测试。
- 把“测试候选通过”“现行巡检已恢复”“业务服务健康”写成三个独立结论。
这不是一次服务故障复盘，而是一次测试夹具把环境路径带进协议约束的排障。对读者有用的不是记住一个固定长度数字，而是先找到失败的地址构造层，避免对着后续超时去重启一个未被证明故障的服务。
本文是 AI 辅助整理的原创工程实践；内部组件、目录与运行入口已匿名化。示例展示可迁移机制，不代表候选修正已并入现行系统。
来源与适用边界
[1] Linux man-pages：unix(7)，核验于 2026-09-23；具体字段容量是 Linux 实现事实，不应推成所有 Unix 平台的统一常数。
