Chrome DevTools Protocol与Chrome版本的关联及连接问题咨询

一、Chrome 114中WebSocket连接失效的原因 #

Chrome 114版本对远程调试的WebSocket连接安全性做了增强限制，核心变化是强制校验WebSocket请求的Origin请求头，具体细节如下：

• 在Chrome 104及更早版本，直接使用http://127.0.0.1:9222/json返回的webSocketDebuggerUrl发起WebSocket连接时，无需额外携带Origin头即可成功建立连接。
• 从Chrome 114开始，默认要求WebSocket请求必须携带与调试端点同源的Origin头（比如Origin: http://127.0.0.1:9222），否则会被Chrome拒绝连接。
• 如果你的连接发起方无法携带正确的Origin头（比如本地脚本、非浏览器环境的客户端），可以在启动Chrome时添加--remote-allow-origins=*参数（或指定具体允许的源，如--remote-allow-origins=127.0.0.1），以此放宽同源限制，恢复旧版本的连接逻辑。

另外需要排查：确认webSocketDebuggerUrl的格式是否正确（114版本的链接格式未发生大变化，仍为ws://127.0.0.1:9222/[会话ID]），以及Chrome是否正确启用了远程调试模式（启动参数需包含--remote-debugging-port=9222）。

二、Chrome DevTools Protocol（CDP）与Chrome版本的对应关系 #

CDP与Chrome版本是强绑定的，二者的版本对应逻辑如下：

• 版本号直接对应：Chrome的主版本号（如104、114）通常直接对应CDP的协议版本号，你可以通过http://127.0.0.1:9222/json/version接口获取Protocol-Version字段，该字段的值与Chrome主版本号一致或高度关联。
• API随版本迭代：每一个Chrome版本都会更新CDP的API，包括新增命令、事件，废弃或修改旧有接口。比如Chrome 114新增了WebAuthn相关的CDP方法，同时可能对Network域的部分参数做了调整。
• 兼容性处理：如果需要跨多个Chrome版本使用CDP，要么针对目标版本编写适配代码，要么使用封装了版本兼容逻辑的工具（如Puppeteer会自动匹配对应Chrome版本的CDP协议）。
• 查看对应关系：通过Chrome的chrome://version页面可以看到当前Chrome的版本，结合json/version接口的协议版本，就能明确当前CDP的版本信息；若需查看历史版本的CDP变化，可以参考Chrome发布日志中关于DevTools的更新记录。

内容的提问来源于stack exchange，提问作者CHUANBING WANG