配置无法读取：先看路径与结构
出现启动失败时，先阅读日志中第一条明确的错误，确认程序实际读取的文件路径。文件不存在、工作目录不同、扩展名多了一层文本后缀，都可能导致看似已经保存但无法加载。图形前端管理的运行配置也可能与手动编辑文件不同。
如果错误指向语法，打开空白符显示，检查缩进、冒号、短横线和引号。提示行之前的未闭合字符串也可能引发后续报错。先恢复最近的可用副本，再逐项重做修改，比连续粘贴新的完整配置更容易找到原因。具体格式见YAML 教程。
字段有效但策略引用失败
语法正确并不等于配置语义有效。策略名称拼写不一致、规则集合没有加载、当前版本不支持某字段，都可能导致启动或运行异常。对照实际版本文档核对字段，而不是凭其他前端截图补写同名选项。尤其注意大小写和看似相同的全角字符。
若前端执行了转换或覆写，检查最终运行配置，确认修改没有被覆盖。外部集合获取失败应检查其来源、格式和网络可达性，不应仅通过上下移动规则解决。引用关系明确后，再验证目标是否满足预期条件，参阅规则优先级指南。
端口冲突与应用没有进入入口
端口占用需要先辨认已有进程。可能是另一个内核实例、前端后台服务或完全不同的程序，不能直接结束所有同名进程。调整监听端口后，还要同步测试应用的代理设置，否则内核运行正常而应用仍在访问旧端口。
如果日志没有出现测试请求，先确认应用是否使用系统代理，是否有独立代理选项，或者是否通过其他网络扩展。不要只看系统开关就推断请求已进入内核。控制接口、代理入口和 DNS 监听端口用途不同，也不能互相替代。
解析失败与连接超时分别处理
域名查询失败时，核对系统、应用和内核的解析路径，确认上游可达并考虑缓存。已经得到地址但连接超时，则继续检查目标端口、规则去向和服务可用性。证书类错误还可能与系统时间、目标身份和网络拦截有关，不应直接关闭验证。
用一个已知可用目标进行对照，记录失败是否影响所有应用和所有目标。网络切换后出现的问题，需要检查旧接口绑定和系统认证状态。一次只更改一个变量，避免将解析、规则与程序版本同时替换，导致无法确认恢复原因。
退出后无法联网与安全分享
程序退出后系统代理可能仍指向已经停止的本地端口。先检查并恢复原有设置，再验证普通网络；移动设备还要看网络扩展和按需连接状态。不要在不知道现有策略用途的情况下重置全部网络或移除组织配置。
需要他人协助时，提供系统、前端、内核来源、问题时间和最小复现步骤。日志与配置应移除订阅密钥、账号令牌、私人地址和身份信息。保留本地副本，在每次调整后用连接检查教程重新验证，确保修复没有引入新的入口问题。
阅读后的检查清单
- 已经找到第一条关键报错及实际配置路径。
- 语法、引用、入口与网络问题分别验证。
- 已保存修改前副本，分享资料已移除敏感信息。