解决 cockpit-tools 导入 sub2api 后报错 invalid ID token format 的问题

最近在摆弄 cockpit-tools 和 sub2api 的时候，有个小伙伴遇到了一个挺让人头秃的错误提示：

invalid ID token format at line 8 column 3

这个错误出现在导入 sub2api 的配置后，尝试启动 Codex 时。乍一看，信息量不大，但其实就是两个字：格式不对。

检查配置文件第8行的语法错误

问题出在哪？

这个报错的核心在于“ID token format”不合法。通常意味着在解析配置文件（很可能是 JSON 格式）的第 8 行第 3 列，系统识别到了不符合预期的 Token 格式。

常见原因分析

1. 复制粘贴的锅：很多配置是从别处复制过来的，如果不小心带入了不可见字符（比如零宽空格），或者多余的逗号，解析器就会直接罢工。
2. 版本不兼容：cockpit-tools 和 sub2api 可能都更新了好几个版本了，旧版本的配置字段可能直接在新版本里失效或者改名了。
3. 编码问题：有时候文件编码不是 UTF-8，或者带有 BOM 头，也会导致解析失败。

将文件保存为 UTF-8 无 BOM 格式

解决方案

别慌，按下面的步骤排查，基本能解决问题：

1. 检查第 8 行的语法 打开你的导入文件，直接跳到第 8 行。

• 看看是不是多了个逗号（尤其是在最后一个字段后面）。
• 检查引号是不是配对，有没有混用单引号和双引号。
• 如果这一行是 ID 相关的字段，确认里面的字符串是否包含特殊字符，记得做好转义。

2. “大扫除”去除乱码 建议把配置文件里的内容复制出来，粘贴到一个纯净的记事本里（或者 VS Code 这种能显示不可见字符的编辑器），然后重新保存为 UTF-8 无 BOM 格式。

3. 重新生成配置 如果实在看不出哪里有问题，最笨但也最有效的办法是：删掉当前的导入内容，参照 sub2api 的最新文档，重新生成一份新的配置。别信网上那些“一键配置”的老古董，文档才是真理。

4. 日志是朋友 如果以上都不行，去查一下 cockpit-tools 的详细启动日志。有时候前端报错只会给个大概，后端日志里会有详细的堆栈信息，告诉你是哪个字段具体出了问题。

总结

遇到这种报错，90% 都是配置文件的小低级错误。细心检查一下格式，更新一下文档，一般都能顺利解决。希望这篇小短文能帮大家节省点排查时间，少掉几根头发！