适用范围与准备

适用于给代理客户端合并配置片段后,出现duplicate key、mapping key already defined或配置值不符合预期的情况。保留原始配置和仍可用的运行实例,只编辑副本;不要把完整订阅粘贴到在线YAML检查网站。

先区分原因

YAML映射要求同一映射中的键唯一。把两个dns块直接接在文件里,并不表示它们会自动合并;不同读取工具可能报错,也可能只保留其中一份。另一个层级出现相同名字则未必重复,例如顶层ipv6与dns下的ipv6是两个路径。

按顺序操作

  1. 从客户端错误中记录文件名、行号和键名,先确认是完整配置、节点文件还是规则文件。找到客户端实际加载的副本;如果内容由订阅、覆写和界面选项组合生成,应定位生成来源,不只修改下次就被覆盖的输出文件。
  2. 在本地文本编辑器中显示行号和空白字符,搜索被报告的键,并比较缩进所属的父级。不要全局删除所有同名字段;不同代理项中的name、server以及不同层级中的enable并不属于同一个映射。
  3. 同层确有两个同名配置块时,先在副本里逐项对照内容,将需要的子项合到一个块中。子项也同名时,依据实际意图选择一个值,记录理由;列表要按该字段的结构整理,不能用“后写的总会覆盖”作为跨客户端通用规则。
  4. 用下面的示意确认层级,再使用当前客户端或内核自带的配置检查入口验证完整副本。示意片段没有节点和完整DNS上游,不能拿来替换整份配置;检查可能读取引用资源,不能把它称作一定离线且无副作用的操作。
  5. 检查通过后,按客户端支持的方式加载这份副本,核对实际生效值与原来可用的功能。若错误变成字段类型或资源路径问题,按新的错误继续处理;语法通过不等于节点连接、DNS或分流正确。
错误示意:同一层的dns重复;不要导入使用
dns:
  enable: true
dns:
  ipv6: false
整理后的结构示意;只说明合并方式,不是完整可运行配置
dns:
  enable: true
  ipv6: false
不同路径可以同名;这两项含义须分别查配置文档
ipv6: true
dns:
  ipv6: false
结构如何判断
同一映射出现两个dns重复键,应整理
dns中同时写两次enable子映射内仍然重复
顶层ipv6和dns.ipv6路径不同,不是重复键
两个列表项各有name各自映射中的字段,不靠改名修语法

怎样确认有效

客户端应明确报告加载成功,生成后的配置只保留预期的同层键;再用固定目标做一次与原设置一致的请求验证。本地解析器能读出字典仅能说明它接受了输入,不能证明原文件符合唯一键要求或内核已加载。

无效时恢复与下一步

副本仍有错误或加载后影响原功能时,回到原配置和记录的覆写设置,不删除唯一可用订阅。求助只提供去掉凭据后的最小结构、层级、错误行和客户端版本。本文验证了本地示例的结构及重复键覆盖现象,未在真实代理内核加载用户配置。