Hiddify macOS若显示
duplicate column name: profile_override
和
profile_entries
列重命名SQL,先按
本地数据库迁移报错专项
保留数据并收集只读证据;普通HTTP或解析错误仍按本页分流。
订阅更新出现超时、401、403、429、502、空内容或格式无效时,按获取、响应、解析、加载四个阶段排查。先保存错误原文,再判断失败在哪一层;更新弹窗显示成功,也要继续确认内容能够解析、预期配置已经加载且核心启动没有错误。只有服务端内容本来就应该变化时,才用节点、分组或字段差异继续验收。
先看结论
- 获取失败先查地址、网络和套餐;内容无效再查格式及客户端兼容性。
- 保留错误原文,不公开完整订阅,不把所有问题都归因于节点。
- 把故障拆成“获取请求、服务器响应、内容解析、配置加载”四个阶段。
- 更新恢复后要按“预期是否应变化”核对活动配置与节点列表;服务端内容没有变化时,列表不变也可能是正常结果。
- 一次只改变一种更新方式或一个设置,避免恢复后仍不知道原因。
先保存报错原文
“超时”“连接失败”“无效订阅内容”不是同一个症状。截图时保留错误文字、发生时间和客户端版本,遮住完整链接及令牌。不要先删掉全部配置,这会丢失仍可用的旧状态,也会破坏对照条件。
同样是“格式无效”,先分清解析与内容检查
客户端说格式无效时,先记录完整报错、客户端版本与发生阶段。远程获取失败、HTTP响应、YAML解析失败和顶层字段缺失需要分别排查;不要仅凭“订阅失败”四字判断服务端停运或节点失效。
| 首个明确错误 | 最小可保存证据 | 优先动作 | 专项入口 |
|---|---|---|---|
| 超时、连接被拒绝、HTTP 401/403/429/5xx | 时间、状态码、官方后台是否能重新取得链接 | 核对网络、认证、限流或服务端状态;不要先改 YAML | 本文获取与响应步骤 |
Clash Verge Rev
the remote profile data is invalid yaml
|
客户端版本、脱敏错误、在可信本机看到的响应类型 | 确认是 Clash/Mihomo 配置而非 HTML、Base64 或不完整 YAML | 精确报错排查 |
缺少
proxies
或
proxy-providers
|
顶层字段名称、来源标明的订阅类型 | 核对是否拿错格式及配置是否缺字段;不公开节点密钥 | 精确报错排查 |
| 显示更新成功,但代理列表为空 | 活动配置、提供者状态、代理组引用 |
检查主配置与
proxy-providers
是否分别获取和加载
|
Clash 无节点排查 |
对于完整响应,优先在自己的设备上观察内容类型;不要把带令牌的订阅链接交给在线 YAML 检查工具,也不要上传未脱敏配置。若来源方提供多个格式,只改一次订阅格式并复测同一动作。确定解析已经通过后,继续核对活动配置和核心状态,不能把“更新弹窗消失”当作修复完成。需要尝试公开配置的读者,可以先阅读 免费节点入口的测试口径 ,不要把当批短时通过理解为长期保证。
用证据表判断失败发生在哪一层
| 看到的现象 | 先保存的证据 | 优先检查 | 不能直接得出的结论 |
|---|---|---|---|
| 超时、无法连接 | 时间、网络、更新方式、日志原文 | 本地网络、当前代理路径、服务端状态 | 不能证明订阅失效 |
| 401/403 | HTTP状态、官方后台能否重新复制链接 | 令牌、权限、访问限制 | 403不能直接写成停运 |
| 429 | Retry-After、发生时间、点击次数 | 等待窗口和服务方限流说明 | 不能靠连续刷新解决 |
| 200但节点为零 | 响应类型、内容长度、是否为HTML | 返回内容和客户端格式支持 | 200不等于有效订阅 |
| 节点出现但核心失败 | 核心日志、版本、配置字段 | 核心兼容、字段、端口与文件 | 不属于订阅下载失败 |
同一个403可能来自服务商、网关或访问策略;同一个超时也可能发生在本地网络、代理更新路径或远端服务。表格用于定位下一步,不把错误码自动映射成唯一原因。
地址是不是正确
确认复制的是服务商给出的订阅地址,而不是登录、购买或帮助页面。注意有没有多余空格、缺失字符或已经重置的令牌。客户端要求的订阅格式,也需要在服务商说明中核对。
订阅地址通常含有可直接使用的凭据。排错时不要公开完整URL、二维码或令牌;泄露后应在官方后台重置,而不是只删除截图。
请求没有成功时
先检查基本网络与账户套餐状态,再查看客户端是否允许选择订阅更新的连接方式。部分客户端可以直连更新、通过当前代理更新或使用系统代理;不同方式依赖的网络路径不同。
更新方式的单变量对照
一次只改变更新方式,并记录:
- 客户端、版本与操作系统;
- 发生时间及时区;
- 原更新方式和对照方式;
- HTTP状态或错误原文;
- 是否所有网络都失败;
- 是否只有这一份订阅失败。
如果当前代理节点已经失效,“通过代理更新”可能超时;如果服务端限制某些来源,“直连更新”也可能失败。对照结果只能缩小范围,不能脱离日志直接认定责任方。
如果明确收到401或403
401通常表示请求缺少有效身份验证凭据;403表示服务器理解请求但拒绝处理。先核对官方后台提供的订阅地址、令牌是否重置和账户权限,再向服务方提供错误文字。
仅凭状态码不能认定套餐过期,也不能确定响应来自服务商应用还是中间网关。403更不能直接写成服务停止运营。
如果收到429,停止反复点击更新
429表示一定时间内请求过多,可能附带Retry-After等待提示。限流规则可能针对IP、用户或应用。记录发生时间,停止反复请求,并按Retry-After或服务方说明等待;429本身不能证明账户被盗用。
如果收到502或只有超时
502表示网关或代理收到无效上游响应,需要结合服务方状态和请求路径判断。超时只说明一次等待没有及时完成,不能证明远端返回了某个HTTP状态。保留发生时间、错误原文和更新方式,便于服务方查同一时段记录。
200和“下载完成”为什么仍然不能导入
HTTP 200只说明请求按HTTP层面成功返回。仍要检查:
- 内容是不是空白;
- 是不是登录页、验证码页、HTML错误页或套餐提示;
- 是否为当前客户端支持的订阅格式;
- 内容能否被客户端解析;
- 预期配置是否成为活动配置;
- 核心能否无错误加载该配置;
- 只有服务端内容预期变化时,节点、分组或字段是否出现对应差异。
网页错误提示也可能被包装在200响应中。排错时只记录内容类型、长度、错误片段和脱敏字段,不要把完整订阅复制到公共检测站。
请求成功但内容无效时
返回内容可能为空、是错误页面,或是客户端不支持的配置格式。不要把格式错误等同于线路速度慢。向服务商说明客户端名称、版本和错误原文,请其确认对应订阅格式。
若Clash Verge Rev显示更新完成但没有任何节点,使用 Clash订阅更新成功但没有节点专项排查 ;它负责配置内容和节点列表,不在本文重复展开。
证书报错不要直接忽略
先核对系统时间、订阅地址和服务商的证书情况。关闭证书校验会改变连接安全性,不应当作为默认解决办法。需要特殊设置时,先理解影响并要求服务方给出明确依据。
Clash Verge Rev 日志出现 UnknownIssuer 时
client error (Connect): invalid peer certificate: UnknownIssuer 表示已进入TLS验证阶段,和URL输入即被拒绝、HTTP 401/403或YAML解析失败分开处理。先保留旧配置、脱敏日志与时间;不要默认关闭证书验证。官方问题 #8198 是一个尚无维护者确认根因的用户个案。三组最小对照、来源侧与设备侧判断及限制集中见UnknownIssuer 证书错误专项。
按四个阶段判断错误位置
- 获取请求:客户端能否发出并完成请求。
- 服务器响应:服务器返回什么状态和内容类型。
- 内容解析:返回内容能否被当前客户端识别。
- 配置加载:解析后的配置能否设为活动配置并由核心加载。
每一阶段的证据不同。不要把“节点连不上”当作“订阅更新失败”,也不要把“请求200”当作配置已经加载。
Clash Verge Rev、v2rayN、Karing分别看什么
- Clash Verge Rev:确认订阅已经保存、更新并激活,配置内确实包含节点。
- v2rayN:确认订阅分组启用、服务器列表出现内容、目标节点设为活动服务器。
- Karing:确认配置已添加,刷新时间和节点数量发生预期变化。
按钮名称可能随版本变化,但都应记录客户端版本、错误原文和失败阶段。若v2rayN已经出现节点、界面显示连接,却打不开网页,应转到 v2rayN连接成功但打不开网页排查 ,避免把流量接管故障误判成订阅更新问题。
更新成功后的分层验收
不要只看弹窗,也不要要求每次更新后节点数量必然变化。先确认服务方是否预期内容发生变化,再分开记录:
- 获取层:请求完成,状态与响应类型符合预期;
- 解析层:内容能被客户端识别,没有空内容或格式错误;
- 加载层:预期配置成为活动配置,核心启动没有错误;
- 差异层:只有服务端内容预期变化时,才要求节点、分组或字段出现对应变化;
- 流量层:选择节点后的HTTPS访问另行记录,失败时转入连接路径排查,不倒推为订阅更新失败;
- 恢复层:退出客户端后普通网络能够恢复。
若更新时间变化但节点列表完全不变,先确认服务端内容是否本就没有变化;只有预期变化却未出现时,才继续检查缓存、订阅分组和实际响应内容。
失败时的安全回退
更新前不要删除仍能使用的旧配置。若新内容导致核心无法启动,先切回旧配置或停用新分组;若普通网络也失败,按顺序清除系统代理、关闭TUN、退出客户端、核对Windows没有残留旧的
127.0.0.1:端口
,再验证普通网络。不要通过关闭证书校验、安装未知证书或上传私人订阅来换取“更新成功”。
需要了解公开配置的来源与使用边界时,可查看 免费节点页面 。来源可访问、格式可解析和节点能连通是三个不同门槛;是否存在当批可下载节点及第三方依据,以页面实际展示为准。
什么时候升级处理
地址、套餐、网络、响应和格式已经核对仍失败时,给客服提供发生时间、客户端版本与已尝试步骤。单个GitHub问题记录只能说明有人遇到类似症状,不能证明你遇到了同一个原因。
给客服的最小信息包
提供发生时间及时区、客户端和版本、系统、HTTP状态或错误原文、订阅是否能在官方后台重新复制、是否所有网络都失败,以及已经做过的单项测试。遮住完整URL、令牌、账户、二维码和支付信息。
来源与更新记录
- Clash Verge Rev官方订阅导入文档 。
- v2rayN官方项目中的无效订阅内容问题记录 。
- MDN关于HTTP 401 、 403 、 429 和 502 的状态说明。MDN说明429响应可能包含Retry-After,用于提示客户端多久后重试。
本次深修增加故障证据表、200响应识别、更新方式单变量对照、成功后的差异验收和安全回退。没有把客户端操作、线路测速或服务商状态写成本站实测。
无法选中订阅,不等于订阅更新失败
客户端已取得配置但无法选中时,先检查本地内核与端口日志;若出现 socket 权限错误,转到无法选中配置与端口排查。这与HTTP状态、证书和YAML解析是不同阶段。
| 阶段 | 典型证据 | 不要混用的修复 |
|---|---|---|
| 获取 | 401/403/429、超时、证书错误 | 不要先删本地配置 |
| 解析 | HTML登录页、空正文、YAML/JSON错误 | 不要重启HNS |
| 载入 | 节点为空、覆写后为空、活动配置未切换 | 不要反复请求服务器 |
| 选中 | 特定socket权限错误、HNS状态异常 | 不要当作401/403 |
| 接管 | 系统代理、TUN、DNS或规则日志 | 不要继续刷新订阅 |
常见问题
订阅返回HTTP 200,为什么客户端仍提示更新失败?
HTTP 200只代表服务器返回了响应,内容仍可能是登录页、错误HTML、空文件或不兼容配置。应比较Content-Type、文件大小、内容开头和客户端解析日志,并注意隐藏完整订阅令牌。
订阅链接在浏览器能打开,是否说明链接没有问题?
不能。浏览器能显示文本不等于客户端能识别格式,也不代表返回内容包含有效节点。需要核对是否发生跳转、是否要求登录,以及响应是节点URI、Base64订阅、YAML还是网页。
更新失败时可以使用在线订阅转换网站吗?
不建议把私人订阅直接提交给未知转换站,因为链接通常包含可被滥用的访问令牌。优先使用服务方提供的客户端专用订阅、本地可信转换工具或官方支持的格式,并在泄露后及时重置订阅。