Postman调用Dialogflow提示GCP API key无效该如何排查？

1. 优先验证API密钥配置 #

• 检查Postman参数传递方式：API密钥需以key为参数名放在URL查询参数中，或放到X-Goog-Api-Key请求头里，同一请求不要同时传API密钥和OAuth/Bearer凭证，会触发优先级冲突
• 核对GCP控制台API密钥的配置限制：确认该密钥没有设置IP白名单、应用限制、API访问限制，且dialogflow.googleapis.com已经被加入该密钥的允许调用API列表
• 确认密钥所属的GCP项目和你要操作的Dialogflow agent所属项目完全一致，跨项目的API密钥默认没有访问权限

2. 排查OAuth/Bearer Token配置问题 #

如果你使用OAuth凭证或gcloud生成的Bearer token调用，要完全删除请求中的API密钥参数，按以下规则配置：

• 请求头添加Authorization: Bearer <你的token内容>，不要加多余空格或特殊字符
• 验证gcloud生成的token有效性：gcloud auth print-access-token生成的token有效期仅1小时，过期后需重新生成；同时确认执行gcloud命令的账号已经在对应GCP项目中被授予Dialogflow API Admin或Dialogflow Intent Admin权限
• 检查OAuth凭证的授权范围，必须包含https://www.googleapis.com/auth/dialogflow或https://www.googleapis.com/auth/cloud-platform

3. 核对请求路径与项目参数 #

• 确认请求URL中的项目ID和Dialogflow agent所属的项目ID完全一致，正确路径格式参考：https://dialogflow.googleapis.com/v2/projects/<你的项目ID>/agent/intents
• 不要混淆GCP项目名称和项目ID，项目ID是全局唯一的字符串，可在GCP控制台首页直接查询

4. 对比API Explorer的请求参数 #

API Explorer调用成功的情况下，可以直接查看它生成的请求示例：

打开API Explorer的调用页面，点击「显示代码示例」，选择HTTP选项，把里面的请求头、URL参数和你Postman里的配置逐一对比，排查漏填、错填的参数
以上步骤排查完成后仍报错的话，可以在GCP控制台「API和服务→凭据→API密钥」页面重新生成一个无限制密钥测试，排除密钥本身被禁用或损坏的问题。

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