哪些字符最常触发解析失败?

字符或片段常见来源修法
//从教程复制注释删除注释
末尾逗号手工编辑数组删除最后一项逗号
“server”中文输入法改成英文双引号
<html>订阅返回网页换 JSON 输出入口

电脑端怎么做最小检查?

安装 sing-box 后执行 sing-box check -c config.json。它会给出字段和位置,比手机端弹窗可靠。

如果文件很长,先保留一个 mixed inbound 和一个 direct outbound,确认框架能启动,再逐段加回 DNS、route 和节点。

为什么从 Clash 配置转来容易坏?

Clash/Mihomo 常用 YAML,sing-box 使用 JSON。缩进、数组、对象和字段名都不同,不能把 YAML 直接改扩展名。

订阅转换后仍要看 inboundsoutboundsroutedns 是否符合 sing-box 文档。跨客户端切换时,兼容 Clash / Singbox / V2Ray 的订阅比手工改字段更省错。

Android 和 iOS 有什么差异?

Android 端常见问题是导入剪贴板时丢字符。iOS 端更多是从文件 App 导入时拿到旧版本文件。

两端都建议先用电脑生成通过 check 的 JSON,再通过文件导入,不要在手机上直接改长配置。

怎么确认已经修好?

sing-box check 返回 Configuration is valid,客户端启动后日志不再出现 parse config。再打开本地代理端口,访问一个普通 HTTPS 网站测试规则命中。

主编补充:执行前后怎么留痕

sing-box JSON 解析 invalid character 怎么修这类问题,读完「哪些字符最常触发解析失败?」之后,先写下当前状态:谁在操作、用的哪个账号或设备、最近改过什么。再对照「电脑端怎么做最小检查?」每次只改一个变量,成功和失败都截图或保存日志。客户端配置要先保存原文件和日志,再改订阅、DNS 或规则。这样下次同类问题出现时,团队不用重新猜原因。

交付前再做一次复核

sing-box JSON 解析 invalid character 怎么修处理完以后,不要只看页面是否恢复。先把这次改过的客户端配置、DNS、路由规则和日志列成一行记录,写清楚原值、新值、操作人和时间点。再回到「哪些字符最常触发解析失败?」和「电脑端怎么做最小检查?」两处,对照正文里的判断条件复测一次。

如果复测结果和预期不同,先回滚最近一次修改,再看日志或后台提示是否变化。这样做会多花几分钟,但能避免下次同类问题出现时,只剩一句「之前好像改过」。团队协作时,这条记录也能直接变成客服回复、工单备注或内部 SOP 的证据。

相关阅读

FAQ

sing-box 配置里可以写注释吗?

标准 JSON 不支持注释。部分编辑器会高亮通过,但 sing-box 加载时仍会失败,建议把说明写到单独文本里。

invalid character at beginning 是什么问题?

如果第一个字符是小于号,多半是接口返回了 HTML。先保存响应内容,确认不是登录页、错误页或 CDN 页面。

手机端怎么排查 JSON 错误?

把配置发到电脑上用格式化工具或 sing-box check 检查,再导回手机。手机端日志通常只显示片段,不适合长配置排错。