Stash常见配置和连接问题排查

配置加载失败时检查结构

遇到解析错误，先保存原文件并查看报错附近的行以及上一层缩进。YAML 混用空格与制表符、缺少引号、重复顶层字段，都可能导致读取异常。不要通过连续删除报错行让配置勉强通过，应该理解字段所属的结构。

从其它客户端迁移的配置，还需检查字段支持情况与版本条件。文件格式相同不表示全部功能相同。先使用官方文档中的最小相关结构对照，再逐项加入自己的设置，避免同时引入多个未知因素。

确认策略组引用的成员存在，名称与拼写一致，远程代理集已经取回并且包含有效内容。加载成功只证明配置通过某些检查，不保证其中描述的每个连接资源都可用，更不代表账号权限一定有效。

若资源来自你有权使用的服务，核对服务状态与到期情况。不要在公开求助中贴出完整订阅链接。先让单个已知资源通过最简单路径验证，再逐步检查分组与规则，减少问题范围。

解析失败、连接超时和目标返回错误并不是同一问题。先检查基础网络，再看多个目标是否都受影响。只有一个网站失败时，可能涉及其自身服务、某条规则或某个资源，不必立即重装整个客户端。

若客户端显示连接正常，继续验证真实请求和业务功能。网页缓存可能掩盖当前网络状态，应重新发起请求。查看日志时将错误与发生时间、目标和命中规则关联起来，不能只截取一个状态图标。

网络切换会改变地址、解析和路由，原有连接可能需要重建。先确认新网络接入与认证完成，再检查客户端与应用恢复。只在切换后发生的问题，可参考网络切换专题建立有方向的对照。

停止桌面客户端后仍无法访问时，检查此前手动设置的系统代理是否残留，并按原值恢复。不要使用陌生脚本清理注册表或删除系统网络接口。工作设备尤其应保留管理配置，必要时联系负责网络的人。

一次只改变一个变量，保留原配置和修改记录。反复更换 DNS、策略、网络模式和远程配置，会让结果失去可比性。若无法确认当前状态，先恢复到已知可用副本，然后从基础网络开始检查。

反馈材料应包含系统、网络类型、时间、最短复现步骤与脱敏错误。删除密码、令牌、内部地址和个人信息，再通过可信渠道求助。对于尚处早期发布阶段的平台，先查看当前发布说明，确认是否已有相关限制或调整。