哪些字符最常触发解析失败?
| 字符或片段 | 常见来源 | 修法 |
|---|---|---|
// | 从教程复制注释 | 删除注释 |
| 末尾逗号 | 手工编辑数组 | 删除最后一项逗号 |
“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 直接改扩展名。
订阅转换后仍要看 inbounds、outbounds、route、dns 是否符合 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 检查,再导回手机。手机端日志通常只显示片段,不适合长配置排错。