Mihomo Party 导入订阅失败：按下载、解析、启用 4 层定位
简答：Mihomo Party 导入订阅失败，先保留旧配置，确认 URL 完整且返回 Clash/Mihomo 配置，再按 HTTP 响应、YAML 解析、节点字段和配置启用逐层排查。
定义：Mihomo Party 导入订阅失败，是指客户端在下载、识别、解析、生成或启用远程配置的某个环节没有完成，不一定代表订阅地址已经失效。
先试这一步：用 4 层路径判断卡在哪里
更新于 2026 年 11 月 10 日。先不要删除旧配置，也不要连续点击更新。先按照“立即报错看 URL/HTTP；YAML 报错看返回内容；节点为 0 看 proxies 或 proxy-providers；节点存在但不上网看当前配置和系统代理”的顺序定位。
| 看到的现象 | 优先判断 | 下一步操作 | 成功判据 |
|---|---|---|---|
| 点击导入后立即失败 | 下载、链接或权限问题 | 检查 URL 是否完整，再看错误码和响应内容 | 能取得配置文本，而不是登录页或 HTML |
| 出现 YAML parse error | 内容格式或覆写处理问题 | 暂时关闭合并、覆写或自定义规则后重新导入 | 配置能够被识别并保存 |
| 导入完成但节点为 0 | 没有可识别的 proxies 或 proxy-providers | 检查订阅格式、代理集合和策略组引用 | 配置中出现可选择的代理或代理集合 |
| 节点出现但无法联网 | 配置未切换、系统代理未启用或 TUN 未接管 | 确认当前配置、运行状态和按需启用的流量入口 | 目标应用的连接进入客户端并能完成访问 |
| 更新后仍显示旧节点 | 更新没有成功，或当前运行的不是刚更新的配置 | 查看更新时间、当前配置名称和日志 | 当前配置内容与更新时间一致 |
这里的“导入”“更新”“切换当前配置”“开启系统代理”和“启用 TUN”不是同一个动作。mihomo 文档也将代理端口、TUN 和 Listener 分为不同的入站方式，因此导入成功不等于流量已经接管。可参考 mihomo 入站配置文档。
Mihomo Party 订阅导入的实际操作顺序
- 保留当前可用配置。如果客户端中已有能运行的配置，先不要删除、覆盖或清空数据目录。优先新建一个测试配置，避免错误订阅直接替换正在使用的配置。
- 进入配置或订阅管理页面。不同版本的界面文字可能不同，常见入口包括“Profiles”“配置”“订阅”或侧边栏中的配置页面。当前版本以实际显示为准，不要因为菜单名称略有不同就重复卸载。
- 粘贴完整订阅 URL。使用服务提供方提供的 Clash 或 Mihomo 格式地址，不要使用登录页、后台首页、普通网页或单次下载页面。不要手动删除问号后的参数，也不要把长链接复制成多行。
- 先验证或导入，再切换。如果界面提供“验证”“导入”“更新”或类似按钮，先对新配置执行下载和解析；确认没有错误后，再选择该配置作为当前配置。公开 Issue 显示，远程配置可能通过轻量检查，但在生成运行配置时因策略组引用错误而失败，因此“能下载”不等于“能运行”。详见 Mihomo Party 配置更新与运行校验 Issue。
- 检查当前配置和运行状态。导入后确认当前选中的配置名称、更新时间、节点列表和策略组是否来自刚导入的内容。完成这一步后，才按需要开启系统代理或 TUN。
- 确认应用流量是否进入客户端。如果配置已经加载、节点可以测试延迟，但浏览器或应用仍然无法访问，停止重复导入，转入系统代理、TUN、端口和规则排查。
Windows、macOS 和 Linux 的窗口布局、托盘入口和菜单文字可能随版本或桌面环境变化。能够从公开发布记录确认的是，Mihomo Party 的版本记录包含订阅导入时的 HTML 检测、配置文件解析错误处理、订阅超时设置和配置切换相关修复；具体按钮位置应以当前安装版本界面为准，参见 Mihomo Party Releases。
按报错关键词排查：401、403、404、429、timeout 和 YAML
| 报错或现象 | 常见可能性 | 看到什么后点哪里或做什么 | 不要做什么 |
|---|---|---|---|
401 | 鉴权信息未被接受，或账号状态需要确认 | 回到服务提供方页面重新复制完整订阅 URL，再进行一次导入 | 不要自行猜测、截断或改写令牌 |
403 | 当前请求被拒绝，可能与权限、访问策略或网络有关 | 检查账号页面，并用另一条正常网络进行一次对照测试 | 不要仅凭 403 断定订阅已经过期 |
404 | 地址路径不存在或已发生变化 | 重新进入服务提供方页面生成地址，再替换客户端中的旧 URL | 不要持续刷新同一个旧地址 |
429 | 短时间请求过多的可能性较高 | 停止连续更新，等待后只进行一次复测，并检查自动更新间隔 | 不要反复点击更新按钮 |
timeout | 下载请求未在客户端等待时间内完成 | 切换 Wi-Fi 或手机热点，关闭其他代理后再测一次 | 不要同时运行多个客户端反复请求 |
DNS failed | 域名解析或当前网络连接异常的可能性 | 先检查当前网络和 DNS，再确认订阅域名是否能被正常解析 | 不要先修改 YAML 字段 |
YAML parse error | 返回内容不是可解析的 YAML，或字段、缩进与当前处理方式不兼容 | 检查返回内容类型，暂时停用覆写或合并配置后重新导入 | 不要直接手改整份订阅并覆盖原配置 |
unsupported proxy type | 当前内核不识别订阅中的代理类型或参数 | 核对客户端内核和订阅格式是否匹配，再确认兼容格式 | 不要把不兼容字段硬改成其他协议 |
Profile missing proxies or providers | 配置中缺少可识别的 proxies 或 proxy-providers | 检查订阅是否只有策略组和规则，或节点是否依赖覆写注入 | 不要把“节点为空”直接当作链接失效 |
状态码和错误关键词只能作为定位线索，不能单独证明账号、订阅或服务状态。排查时应同时记录错误类型、发生时间、系统平台和是否换网络成功，但不要公开完整订阅 URL。
公开 Issue 记录过一种特殊情况：远程配置包含策略组和规则，但节点由覆写注入，Mihomo Party 仍出现 Profile missing proxies or providers。该记录只能证明存在这一类客户端个案，不能证明所有相同错误都由同一原因造成，详情见 Mihomo Party 相关 Issue。
节点为空、策略组消失或更新后仍显示旧内容
- 先确认订阅返回的内容类型。完整 Mihomo 配置通常可能包含
proxies、proxy-providers、proxy-groups和rules等字段；只包含规则和策略组的模板不一定自带节点。 - 检查代理字段是否可识别。mihomo 的代理配置有明确字段分类，代理条目通常需要符合对应协议的字段结构。不要只看文件扩展名是否为
.yaml，还要确认内容确实是适合当前内核的配置。字段说明见 mihomo 代理配置文档。 - 检查代理集合引用。如果策略组引用了不存在的代理集合，或者代理集合名称与策略组引用不一致，可能出现节点为空或运行配置生成失败。代理集合属于独立配置分类，字段和更新机制见 mihomo 代理集合配置文档。
- 暂时关闭合并、覆写和自定义规则。如果关闭后能够导入，问题更可能出在覆写字段、策略组引用或合并结果。先保存原设置，再逐项恢复，每恢复一项就重新载入一次。
- 重新载入并切换当前配置。更新完成后检查配置名称、更新时间、节点数量和策略组名称。若节点列表仍是旧内容，先确认当前运行的是否为刚更新的配置，再进行下一次请求。
回滚路径：停止继续编辑，选择导入前仍可用的旧配置；关闭刚添加的覆写或合并项；重新载入旧配置。如果旧配置也无法启动，优先恢复已有备份。不同系统和版本的数据目录可能不同，未确认路径前不建议照抄清理命令或直接删除客户端目录。
导入成功但无法联网：什么时候转入网络排查
当同时满足“配置能够加载、节点或代理集合出现、当前配置已经选中”三个条件，而浏览器或应用仍然无法访问时，才转入网络接管排查。此时继续重复导入通常不能解决系统代理或 TUN 问题。
- 系统代理：检查客户端是否按需启用了系统代理，以及系统中是否被其他程序改回直连。
- TUN：如果依赖 TUN 接管不使用系统代理的应用，检查 TUN 是否启用、权限是否正常。TUN 与普通代理端口是不同入站方式，不能互相替代，参考 mihomo 入站配置文档。
- 端口冲突：检查是否同时运行多个代理客户端、VPN、抓包工具或安全软件。若日志提示端口被占用，先关闭冲突程序再重新启动客户端。
- 规则模式：如果只有部分网站或应用失败，检查当前模式、策略组和规则命中情况；不要把部分应用失败重新归因于订阅导入失败。
- 换网络复测：当前 Wi-Fi 失败而手机热点成功时，重点检查本地 DNS、防火墙、网络认证或其他代理设置。
日志和截图只保留错误关键词、状态码、时间和平台信息，隐藏订阅 URL、鉴权令牌、用户名、服务器地址及完整节点参数。完成导入与启用的区分后，再进入导入后无法联网的排查流程。
常见问题
Mihomo Party 导入订阅失败，最先应该检查什么？
先保留旧配置，确认复制的是完整的 Clash/Mihomo 订阅 URL，而不是登录页或后台地址；再根据 401、429、timeout 或 YAML parse error 判断卡在下载、内容还是解析环节。订阅 URL 可能包含鉴权令牌，不要公开分享。
Mihomo Party 订阅导入成功但没有节点怎么办？
先检查返回内容是否包含 <code>proxies</code> 或 <code>proxy-providers</code>。有些配置只提供规则和策略组，节点依赖代理集合或覆写注入；公开 Issue 也记录过这类导入检查个案，但不能据此断定所有节点为空都由同一原因造成。
Mihomo Party 出现 401、403 和 404，分别怎么处理？
401 优先重新复制完整鉴权地址并确认账号状态；403 检查权限、访问限制和另一条网络；404 回到服务提供方页面重新生成订阅地址。错误码只能作为线索，不能单独证明订阅已经过期。
Mihomo Party 报 429 或 timeout，要不要一直点击更新？
不建议。429 时先停止连续刷新并等待后只复测一次；timeout 时切换网络、关闭其他代理并检查 DNS。连续请求可能让定位更困难，也可能触发更严格的频率限制。
导入订阅后节点出现了，但浏览器还是无法联网，为什么？
导入配置、切换当前配置、开启系统代理和启用 TUN 是不同步骤。先确认当前运行的是刚导入的配置，再检查系统代理、TUN、端口和规则模式；如果只有部分应用失败，应转入流量接管排查，而不是继续重复导入。
Windows、macOS、Linux 的 Mihomo Party 导入按钮一样吗？
不能保证完全一样。公开发布记录可以确认客户端持续包含订阅导入、配置解析和配置切换相关功能，但不同版本、语言和桌面环境的菜单文字可能变化。优先在侧边栏或配置页面查找 Profiles、配置、订阅、导入、更新等同义入口。