JSON开头看不见的BOM为什么会导致解析失败?
复制出来的JSON第一眼就是大括号,校验却把错误指向第一行开头。把同样内容重新敲一遍又能通过,这种时候先别忙着补逗号:文件或复制内容最前面,可能还有一个看不见的字符。
2026年11月17日,本文在JSON格式化中分别输入带开头BOM、不带BOM、以及把同一字符放进字符串的三个样例。使用的都是公开演示文本,没有读取业务文件。
错误位置在大括号之前
第一组实际输入是一个U+FEFF,后面接 {"status":"ready"}。U+FEFF在文件开头常用作字节顺序标记,也就是BOM。截图看不见它的形状,但本次校验的错误条明确指向第一行开头。

这里的关键不是“大括号不合法”,而是它前面多了内容。JSON允许的空白范围很窄,不能把所有肉眼不明显的Unicode字符都当成可忽略空格。标准也区分发送端不应添加BOM、解析器为互操作可以忽略BOM的情况;因此不同程序对同一份带BOM材料的表现可能不同。
本次工具报错,是这次实际解析结果,不意味着所有JSON库都必须显示同一句错误。排查时应保存失败的原始材料,而不是先用另一个宽松解析器转一遍,再说原文件没有问题。
只去掉开头标记,再做一次对照
第二组保留相同的字段和值,只删除最前面的U+FEFF。重新执行校验后,本次出现格式化正确的提示。

不方便定位隐藏字符时,可以在能查看编码的编辑器里检查文件开头;程序中则直接查看字符码点或字节。下面是针对已读入字符串的最小检查,并不是让读者对所有内容执行替换:
const first = text.codePointAt(0);
const startsWithBom = first === 0xFEFF;
const cleaned = startsWithBom ? text.slice(1) : text;
JSON.parse(cleaned);
如果读到的是字节文件,UTF-8 BOM通常表现为 EF BB BF。应先确认实际编码,再决定如何解码;不要把UTF-16文件仅删掉几个字节就当成UTF-8。处理前保留原文件,处理后保存输出和操作说明,才能对照接口签名或文件摘要。
同一个字符位于字符串中,含义不同
第三组把U+FEFF放进 mark 字符串值里,最外层对象直接从大括号开始。本次校验通过。编辑器对特殊字符可能使用占位标记显示,这种显示方式不应当作原始值真的变成了一个普通圆点。

这也是不建议全局删除U+FEFF的原因。位于输入最前面的编码标记,和字符串里的内容字符,处在不同语法位置。接口如果明确需要保留这个字符,简单执行全局替换会改变业务值;即使字符不可见,内容摘要也可能变化。
需要比较处理前后的文件,可以另用文本哈希工具核对,但哈希只回答输入字节是否一致,不会说明差异一定来自BOM。还要把编码、换行和最终输出文件放在同一份排查记录中。
如果去掉开头标记后仍然报错,就继续按新的位置检查引号、控制字符和结构,不必把后续错误都归因给BOM。有效的处理结果应同时满足:解析器通过,字段值符合预期,且对原文做了哪些变更能够说明白。