subscription URL not found：订阅地址返回 404 怎么处理
subscription URL not found (404)严重程度 Medium订阅服务器明确回答这个地址不存在。这与凭据失效（401/403）是两回事——404 指向的是地址本身写错或路径已变更；第一步是回服务方面板重新完整复制一次地址，不要手工补全。
结论
404 在订阅场景里是个信息量很大的状态码，可惜大多数客户端把它和其他失败一起显示为"订阅更新失败"，白白浪费了这条线索。
它明确告诉你三件事：域名解析正常、服务器活着并且响应了、但这个路径在服务器上不存在。这就把嫌疑范围压缩到了地址本身——不是网络问题，不是账号问题，是你手上这串字符与服务器上的实际路径对不上。
适用环境
- 全部桌面与移动平台
- 通过 URL 更新订阅的所有客户端
一分钟快速判断
connproof subscription "https://你的订阅地址"确认状态码确实是 404，然后按这张表区分它与近亲：
| 状态码 | 含义 | 处理方向 |
|---|---|---|
| 404 | 路径不存在 | 重新复制地址（本页） |
| 401 / 403 | 凭据无效或被拒绝 | 账号状态，见 SUB-001 |
| 302 → 登录页 | 服务端认为你未登录 | 见 SUB-004 |
| 200 + HTML | 返回了网页 | 见 SUB-003 |
| 200 + 空 | 内容为空 | 见 SUB-002 |
| 5xx | 服务端内部错误 | 见 HTTP-003 |
区分 404 与 401/403 特别重要：前者你自己就能修（重新复制地址），后者需要处理账号问题。混在一起会让你在错误的方向上浪费时间。
这条错误代表什么
服务器返回 404 意味着它接受了请求、解析了路径、然后在自己的路由表里找不到匹配项。对订阅地址来说，三种情况会造成这个结果：
一、地址复制不完整。 这是最高频的原因，而且比多数人以为的更容易发生：聊天软件会截断长链接、二维码扫描可能丢字符、手动选择复制容易漏掉末尾、从图片里手敲更是错误温床。订阅地址往往很长且包含随机字符串，人眼很难发现少了一两位。
二、服务方更换了路径结构。 订阅系统升级或迁移后，旧路径可能直接下线而不是重定向。这种情况下你的地址"曾经是对的"，这也是为什么它容易被误判为"突然坏了"。
三、订阅被重置。 地址中的标识部分被作废后，服务器不再认识这个路径。这种情况有时表现为 404，有时表现为跳登录页，取决于服务端实现。
ConnProof 如何判断
订阅检测按序验证 URL 结构、DNS、TLS、HTTP 状态与响应内容。当且仅当前面各层都通过、HTTP 状态码恰好为 404 时，才判定为 SUB-005。
这个前置条件很重要：如果 DNS 就失败了，那是 SUB-001 的范畴，报 404 会误导。分层判定保证了"404"这个结论建立在"前面都正常"的基础上。
报告中会明确标注这一区分：
地址判定：服务端返回 404：这个地址不存在，通常是复制不完整或路径已变更（区别于凭据失效的 401/403）
处理步骤（全平台一致）
- 回服务方面板，整体重新复制地址。 不要在旧地址上手工修改——你不知道错在哪一位。用复制按钮，不要手动框选；
- 在客户端里整体替换，而不是编辑其中一段；
- 检查复制路径上有没有截断风险：如果地址是通过聊天软件传到另一台设备的，改用剪贴板同步工具或密码管理器；
- 复测：
connproof subscription "https://新的订阅地址"- 新地址仍返回 404 → 说明面板给出的地址本身有问题，或服务端配置异常，这时才需要联系服务方。把"状态码 404 + 检测时间"两条证据一起提供，他们能直接定位。
手机端的额外注意
手机是这类问题的高发平台：
- 扫码导入在二维码分辨率不足或屏幕反光时可能识别出错，改用"复制链接 + 粘贴导入"更可靠；
- 输入法自动纠错会修改看起来像单词的字符串片段，粘贴后建议核对开头和结尾几位；
- 长按选择复制容易漏掉末尾字符，优先使用页面提供的复制按钮。
如何区分本地问题和服务端问题
| 证据 | 结论 |
|---|---|
| 重新复制后恢复 | 原地址复制截断（本地） |
| 面板地址与手上一致仍 404 | 服务端路径配置（找服务方） |
| 多台设备同一地址都 404 | 地址确实失效（重新获取） |
| 一台 404、另一台正常 | 那台设备的地址抄写有误 |
| 换网络后仍 404 | 与网络无关，不必再换网络试 |
最后一行值得强调：404 是服务器给出的明确回答，换网络、换节点、重启客户端都不会改变它。看到 404 就可以跳过所有网络类排查，直奔地址本身。
仍未解决时收集什么信息
- ConnProof 错误码（SUB-005）与脱敏报告（报告已去除地址中的查询参数）；
- 重新复制地址前后的对照结果；
- 客户端名称和版本、操作系统版本；
- 地址最后一次正常工作的大致时间。
禁止提交：完整订阅链接、密码、验证码、私钥、Token。向客服描述时说明"路径部分返回 404"即可，不需要发出完整地址。
重新运行检测
connproof subscription "https://你的订阅地址" --format markdown --output sub-report.md修复后应返回 200，内容判定为"疑似订阅文本"。
相关文档
更新记录
- 2026-07-29：规则 v1 发布。此前 404 与其他 4xx 一同归入 SUB-001，本次拆分以区分"地址不存在"与"凭据失效"两类完全不同的成因。