全部指南 ➔
客户端排错 进阶技巧 实机校验: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秒开。

专属特惠券码:
这篇文章解决了您的问题吗?
您的反馈将帮助我们不断优化技术排错指南库

同分类下的相关精选指南

查看更多 客户端排错 ➔