调用LiveKit的startRoomCompositeEgress时出现Bad Request错误排查

核心排查方向 #

既然你已经确认房间名、存储桶名、凭证无误，重点检查以下容易遗漏的配置环节：

1. GCP存储桶权限与CORS配置 #

• 给Twilio服务账号配置**存储对象创建者（Storage Object Creator）**权限，别只给泛读泛写权限，确保它能在桶内创建文件。
• 检查存储桶的CORS规则，必须允许https://video.twilio.com作为来源，同时放开PUT、POST方法——Twilio的Egress服务需要直接向桶写入资源，CORS限制会导致请求失败。

2. Egress请求参数格式校验 #

• 确认存储路径格式严格为gs://<bucket-name>/<自定义路径>，路径不能包含特殊字符、空格，且Twilio有权写入该路径层级。
• 如果自定义了video_layout，检查布局参数是否完整（比如grid布局的行列数、轨道选择是否合法），拼写错误很容易触发Bad Request。
• 若指定了audio_sources或video_sources，核对轨道标识是否和前端发布的轨道ID完全匹配，别出现大小写或字符偏差。

3. Twilio账号的Egress权限与日志 #

• 确认你的Twilio账号已开通Room Egress功能，部分基础套餐默认没开，需要升级或联系客服开通。
• 去Twilio控制台的Egress日志里找详细错误信息——TwirRpc.js的POST错误只是表层，日志会明确指出是参数错误、权限不足还是资源不存在。

4. Twilio控制台的GCP凭证配置 #

这是最容易漏掉的关键步骤：Twilio的Egress服务是直接和GCP交互的，你必须在Twilio控制台配置GCP凭证，而不是只在自己的Node后端配置：

• 登录Twilio控制台，进入Video > Settings > Egress，上传你的GCP服务账号密钥（JSON格式），并授权该账号访问目标存储桶。

5. 后端环境的网络与代理 #

• 如果后端部署在有代理的环境中，确保TwirRpc.js的POST请求能正常访问https://video.twilio.com，代理没有拦截或篡改请求头。
• 检查服务器防火墙，确认没有阻止对外的HTTPS请求到Twilio域名。

快速调试技巧 #

• 调用startRoomCompositeEgress前，打印完整请求参数，和Twilio官方示例逐一对比，排除参数缺失或格式错误。
• 用Twilio CLI直接执行twilio api:video:v1:rooms:composite-egress:create命令测试：如果CLI能成功，说明是代码参数问题；如果CLI也失败，就是账号或GCP配置的问题。

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