使用 Clash for Windows、Clash Verge 或 Mihomo 导入配置文件时，如果突然提示：

Cannot Unmarshal

或者日志中出现类似：

cannot unmarshal !!seq into config.RawCfg

通常说明 Clash 在读取 YAML 配置时，发现某个字段的数据格式和客户端预期的格式不一致。

这类问题和普通的节点 Timeout 不一样。

节点超时通常发生在“节点已经成功加载，但连接失败”的阶段；而 Cannot Unmarshal 往往发生在配置文件还没有成功解析的时候。

因此遇到这个错误时，应该优先检查：

  • YAML 配置格式；
  • Clash / Mihomo 内核版本；
  • 订阅生成格式；
  • proxy-groups；
  • rules；
  • rule-providers；
  • DNS 等配置字段。

下面按照最常见的原因逐项排查。

👉获取稳定 Clash / Mihomo 订阅线路

一、Clash Cannot Unmarshal是什么意思？

Unmarshal 可以理解为：

把配置文件中的内容读取并转换成 Clash 能识别的数据结构。

当 Clash 读取 YAML 时，某个字段原本应该是一段普通文本、数字或对象，但实际却出现了列表等其他格式，就可能出现：

cannot unmarshal

例如日志可能显示：

cannot unmarshal !!seq

其中：

!!seq

通常代表 YAML 中的：

Sequence，也就是列表。

可以简单理解成：

Clash原本期待这里出现一个值，但配置文件却给了它一组列表，因此无法正常解析。

二、Cannot Unmarshal和普通YAML错误有什么区别？

普通 YAML 报错比较常见的是：

  • 缩进错误；
  • 冒号错误；
  • 格式不完整；
  • Parse Error。

Cannot Unmarshal 则稍有不同。

有时候整个 YAML 的语法本身是正确的，但：

字段类型写错了。

例如某个参数本来要求：

string

但实际写成：

list

就可能发生这种错误。

因此即使把 YAML 放进普通格式检查器，可能也显示语法正确，但 Clash 仍然无法加载。

三、为什么更新订阅后突然出现Cannot Unmarshal？

这是非常常见的情况。

例如之前一直能够正常使用，某一天点击：

更新订阅

以后突然提示：

cannot unmarshal

可能并不是电脑本身发生了变化，而是服务商更新了订阅模板。

例如：

  • 修改了 proxy-groups；
  • 更新了 DNS 配置；
  • 加入新的 rule-provider；
  • 修改 Mihomo 参数；
  • 使用了旧 Clash 不支持的新格式。

于是就会出现：

旧客户端 + 新配置

无法兼容的情况。

四、Clash for Windows更容易出现Cannot Unmarshal吗？

有可能。

老版 Clash for Windows 已经长期不再适配很多新的 Clash / Mihomo 配置格式。

现在不少订阅配置会使用：

  • VLESS；
  • Reality；
  • AnyTLS；
  • 新版 Rule Provider；
  • Mihomo DNS；
  • 新的代理组参数。

这些内容可能并不适合旧版 Clash for Windows。

所以如果：

同一个订阅在 Clash Verge / Mihomo 可以正常导入，但 Clash for Windows 报 Cannot Unmarshal

就要优先考虑：

客户端兼容性问题。

五、先判断是订阅问题还是客户端问题

最简单的排查方法是：

第一步：测试其他配置

如果其他 Clash 配置可以正常导入，只有某一个订阅出现 Cannot Unmarshal：

大概率是：

该订阅配置本身存在兼容问题。

第二步：同一个订阅换客户端

如果：

Clash for Windows报错；

但最新版 Clash Verge / Mihomo 可以正常加载：

说明问题更可能来自：

旧客户端不支持当前配置格式。

六、Cannot Unmarshal !!seq 是什么意思？

如果日志里完整出现：

cannot unmarshal !!seq

重点检查：

某个字段是不是从单值变成了列表。

例如本来程序期望：

key: value

实际配置却写成：

key:

然后下面跟多个：

- value

这时 YAML 本身可能仍然合法，但对 Clash 来说：

数据类型不符合配置规范。

所以不要只检查有没有少冒号。

还需要检查：

字段本身应该是什么类型。

七、proxy-groups配置错误会触发Cannot Unmarshal吗？

会。

proxy-groups 是 Clash 配置里非常重要的一部分。

例如：

  • type；
  • proxies；
  • use；
  • url；
  • interval；

这些字段都有自己的格式要求。

如果配置生成工具输出了错误结构，就可能导致解析失败。

尤其是在：

  • 手工修改代理组；
  • 从其他配置复制代理组；
  • 不同 Clash 内核配置混用；

之后比较容易发生。

八、rules配置也可能导致Cannot Unmarshal吗？

有可能。

Clash 规则通常类似：

DOMAIN-SUFFIX,example.com,PROXY

如果规则区域被错误写成其他 YAML 结构，或者使用了当前客户端不支持的规则格式，也可能导致配置加载失败。

不过如果日志已经明确指出具体字段，应优先按照日志位置处理，而不是一次性删除全部 rules。

九、Rule Provider会不会导致这个错误？

会。

如果配置引用：

rule-providers

并且 Provider 的结构不符合当前内核要求，就可能出现加载异常。

例如不同版本的 Clash / Mihomo 对：

  • behavior；
  • format；
  • type；
  • path；
  • url；

等字段支持可能不同。

因此从其他教程里直接复制 Rule Provider 配置，尤其容易造成兼容问题。

十、DNS配置错误也可能触发Cannot Unmarshal吗？

有可能。

Mihomo 的 DNS 配置已经比较复杂，例如：

  • nameserver；
  • proxy-server-nameserver；
  • nameserver-policy；
  • fallback；
  • fake-ip-filter。

这些字段中有的要求列表，有的要求映射结构。

如果：

把旧 Clash DNS 写法和新 Mihomo DNS 写法混在一起

就可能出现无法解析。

所以如果错误是在自己修改 DNS 以后才发生，优先恢复原配置。

十一、手动修改YAML后出现Cannot Unmarshal怎么办？

如果错误就是在修改 YAML 后出现的，最快的方法不是继续乱改。

建议：

  1. 保存当前错误配置；
  2. 找回修改前的原始 YAML；
  3. 恢复原配置；
  4. 确认能够正常加载；
  5. 再逐项修改。

不要一次修改：

  • DNS；
  • proxy-groups；
  • rules；
  • TUN；

很多地方。

否则很难判断具体是哪一项导致的。

十二、YAML缩进也需要检查吗？

需要。

虽然 Cannot Unmarshal 通常更偏向字段类型错误，但错误缩进也可能把某个字段变成完全不同的结构。

例如：

原本应该属于某个代理组的内容，因为缩进错误被放到了其他层级。

YAML 对空格非常敏感。

修改时建议：

  • 不使用 Tab；
  • 使用统一空格；
  • 不使用 Word；
  • 使用 VS Code 或 Notepad++。

十三、为什么浏览器能打开订阅，但Clash还是报错？

浏览器能够打开订阅链接，只能说明：

订阅服务器可以访问。

并不代表下载到的内容一定能被当前 Clash 客户端解析。

所以：

订阅能打开 ≠ 配置一定兼容

如果浏览器能看到大量 YAML 内容，但 Clash 导入后报 Cannot Unmarshal，应重点检查：

配置格式和客户端版本。

十四、重新复制订阅链接有用吗？

有时候有用。

尤其是服务商支持多个订阅格式时，例如：

  • Clash；
  • Clash Meta；
  • Mihomo；
  • 通用订阅。

如果当前复制的是：

Mihomo专用配置

却导入旧 Clash for Windows，就可能出现问题。

可以重新进入服务后台，确认选择的是适合当前客户端的订阅类型。

十五、删除配置重新导入有用吗？

如果问题只是本地缓存异常，可能有用。

可以尝试：

  1. 删除出错配置；
  2. 完全退出 Clash；
  3. 重新打开客户端；
  4. 重新复制订阅；
  5. 再次导入。

但如果下载下来的 YAML 本身存在同样的格式问题：

重新导入多少次都会报错。

这时候就应该转向检查：

订阅生成格式或客户端兼容性。

十六、更新Clash内核能解决Cannot Unmarshal吗？

部分情况可以。

如果配置使用了较新的 Mihomo 参数，而当前内核版本较旧，升级以后可能恢复正常。

但要注意：

Cannot Unmarshal 并不一定全部是内核太旧。

如果 YAML 本身字段结构错误，升级内核也不一定能解决。

所以判断顺序建议是：

换最新版客户端测试 → 再判断配置本身。

十七、换成Clash Verge后为什么就正常了？

如果老版 Clash for Windows 报错，而 Clash Verge 使用 Mihomo 内核后正常，通常意味着：

订阅已经开始使用较新的配置规范。

这种情况下，与其强行修改订阅去兼容老客户端，更适合使用支持当前配置格式的新客户端。

尤其是订阅里已经出现：

  • VLESS；
  • Reality；
  • AnyTLS；
  • MRS；

时更应该注意内核兼容问题。

十八、Cannot Unmarshal和Unsupported Proxy Type一样吗？

不一样。

Cannot Unmarshal

主要说明：

整个配置中的某些字段无法正确解析。

Unsupported Proxy Type

说明：

配置已经读取到某个节点，但当前内核不支持该节点协议。

例如：

unsupported proxy type vless

或：

unsupported proxy type anytls

两类错误都可能和客户端版本有关，但出错阶段并不一样。

十九、Cannot Unmarshal和Configuration Validation Failed是什么关系？

Cannot Unmarshal 有可能进一步导致：

Configuration Validation Failed

因为配置连解析都没有成功，自然无法通过后续配置校验。

所以日志可能同时出现：

  • Cannot Unmarshal；
  • Config Parse Error；
  • Configuration Validation Failed。

这时候优先处理最前面的具体错误。

二十、出现Cannot Unmarshal后不要先做什么？

不建议第一时间：

  • 换十几个节点；
  • 开关系统代理；
  • 修改TUN；
  • 修改Windows DNS；
  • 重装网卡。

因为这类错误发生在：

配置解析阶段。

配置没有成功加载时，节点连接设置通常不是核心问题。

正确方向应该是：

客户端版本 → 订阅格式 → YAML字段 → 配置兼容性。

二十一、最快解决方法

如果不想自己研究 YAML，可以按照下面顺序操作。

方法一：更新客户端

升级到较新的 Clash Verge / Mihomo 环境。

方法二：重新获取订阅

确认获取的是：

Clash / Mihomo兼容订阅。

方法三：删除旧配置重新导入

排除旧缓存。

方法四：测试其他订阅

判断是单个配置问题还是整个客户端问题。

方法五：恢复原始YAML

如果自己修改过配置，先恢复修改前版本。

这一套流程可以解决大部分 Cannot Unmarshal 场景。

二十二、如果必须自己修改YAML怎么排查？

建议使用二分法。

例如你修改了：

  • DNS；
  • 规则；
  • 代理组；
  • TUN；

四部分。

不要一起检查。

可以先：

  1. 恢复全部修改；
  2. 只加入 DNS；
  3. 测试；
  4. 再加入规则；
  5. 测试；
  6. 再加入代理组。

这样一旦报错，就能快速定位是哪一部分导致的。

二十三、Clash Cannot Unmarshal常见问题

Cannot Unmarshal是不是节点坏了？

通常不是。

这是配置解析类错误，优先检查 YAML 和客户端兼容性。

换节点有用吗？

配置都没有成功加载时，换节点通常没有意义。

更新订阅以后突然出现正常吗？

有可能。服务商修改配置模板后，旧客户端可能无法识别新的字段格式。

可以继续使用Clash for Windows吗？

如果当前订阅配置仍然兼容可以使用；如果频繁出现新协议或新配置不兼容，建议考虑支持 Mihomo 的新客户端。

删除YAML重新导入就一定能解决吗？

不一定。如果服务器每次下发的仍然是同一份错误或不兼容配置，重新导入仍然会报错。

Cannot Unmarshal和YAML Parse Error是一回事吗？

不完全一样。Parse Error更偏向语法错误，Cannot Unmarshal更多是配置字段类型与程序预期不一致。

总结

Clash 出现 Cannot Unmarshal 时，核心问题通常不是节点网络，而是：

YAML配置结构与当前Clash / Mihomo客户端无法正确匹配。

尤其出现：

cannot unmarshal !!seq

时，更应该检查某个字段是不是错误地写成了列表。

推荐排查顺序：

更新客户端 → 重新获取正确订阅格式 → 删除旧配置重新导入 → 检查YAML字段 → 排查proxy-groups、DNS和Rule Provider。

如果同一个订阅在最新版 Clash Verge / Mihomo 可以正常使用，而老版 Clash for Windows 一直报 Cannot Unmarshal，就应优先考虑客户端配置兼容性，而不是继续反复修改节点或网络设置。

这类问题的关键是：

先让配置成功加载，再处理节点和网络。

相关阅读

如果你在处理 Clash Cannot Unmarshal 时，还遇到 YAML、配置校验、内核或协议兼容问题，可以继续查看：