客户端排错 进阶技巧
实机校验:2026-01-28
⏱️ 预计耗时:4分钟
Sing-box 启动提示 JSON 配置文件语法错误(parse error)如何排查?
💡
核心诊断速读: Sing-box 采用强类型的严格 JSON 规范,缺少逗号、多余括号或字段类型不符都会导致闪退,教你快速校验修复。
一、故障现象与典型场景
手动编辑或导入 Sing-box 配置文件后点击启动,日志瞬间打印红字 `fatal error: decode config: invalid character '}' looking for beginning of object key string` 并直接闪退。
二、为什么会出现该问题?根本原因排查
1 JSON 严格语法中,最后一个元素后面误加了英文逗号 `,`(Trailing Comma)
2 误在配置文件中使用了未转义的单引号 `'` 代替标准双引号 `"`
3 Sing-box 大版本升级后,某些字段名称(如 `inbounds` 下的字段)废弃修改,与旧配置冲突
📋 30 秒实机排障自检清单
0 / 5 已排查在进行深度修复前,点击勾选以下基础排查项(90% 的连接异常皆由以下细微疏漏引起):
三、分步实操排障解决方案
1
步骤 1:使用在线 JSON 校验工具排查格式
将整段 `config.json` 复制到 jsonlint.com 或 VS Code 中,编辑器会精准红线标出在哪一行哪一列缺少了括号或有多余逗号。
2
步骤 2:使用 Sing-box 命令行自检语法
在终端中执行内置的校验命令,无需启动服务即可快速定位语法错误:
执行命令 / 配置文件
sing-box check -c config.json ⚡ 老司机避坑建议 (Pro Tips)
- • 新手不建议纯手动手写复杂的 Sing-box JSON,建议使用图形化客户端或机场提供的一键生成工具。
针对此问题的推荐加速方案
隐形人 2026年度编辑终极大奖·全站首推
💡 推荐理由:2026综合首选专线旗舰,全节点低延迟,稳定运行99.9%。新加坡团队打造 · 全球全IEPL物理专线 · VLESS新协议 · 0公网不过GFW · 晚高峰4K/8K秒开。
专属特惠券码:
这篇文章解决了您的问题吗?
您的反馈将帮助我们不断优化技术排错指南库
同分类下的相关精选指南
查看更多 客户端排错 ➔
⏱️ 4分钟 · 高频故障
阅读解答 ➔ Clash Verge 开启系统代理后网页无法打开或无网络连接怎么办?
⏱️ 3分钟 · 高频故障
阅读解答 ➔ 提示“127.0.0.1:7890 拒绝连接”或“代理服务器无响应”怎么解决?
⏱️ 4分钟 · 高频故障
阅读解答 ➔ Clash 导入或更新订阅时提示“Invalid Profile”或网络请求失败怎么办?
⏱️ 3分钟 · 新手必读
阅读解答 ➔ Shadowrocket (小火箭) 导入订阅提示“格式错误 / 节点为空”排查方法
⏱️ 5分钟 · 高频故障
阅读解答 ➔ 客户端所有节点全部显示超时(标红/9999ms)的五大根本原因与修复
⏱️ 4分钟 · 深度科普
阅读解答 ➔