App Engine标准环境Java 11项目无法启用GCloud Debugger问题咨询

报错说明 #

触发的错误信息为：

The debugger could not find a debug target for the application name (project-test).

该错误为Google Cloud Debugger无法识别App Engine应用对应的调试目标导致，常见成因和修复方案如下：

可能的成因 #

• 自定义了app.yaml的entrypoint参数，覆盖了App Engine Java 11运行时默认注入的Debugger代理启动参数，导致调试代理没有随应用成功启动
• 调试使用的GCP账号缺少对应IAM权限，无法拉取项目下注册的调试目标列表
• 待调试的App Engine版本没有分配任何流量，Debugger默认不会识别零流量的版本作为有效调试目标
• 项目未启用Cloud Debugger API，导致调试代理无法上报注册信息到Cloud Debugger服务
• 应用启动过程中Debugger代理初始化失败，可通过Cloud Logging查看相关报错日志

修复步骤 #

1. 检查app.yaml启动配置
   如果你的项目自定义了entrypoint启动命令，需要手动在Java启动参数中加入Debugger代理配置，示例配置如下：

entrypoint: java -agentpath:/opt/cdbg/cdbg_java_agent.so=--logtostderr -jar your-application.jar

如果没有自定义entrypoint，可跳过这一步，运行时会默认注入该代理参数。

2. 核对调试账号的IAM权限
   给当前使用的调试账号授予Cloud Debugger User和Cloud Debugger Agent角色，确保账号拥有查询、注册调试目标的权限。

3. 调整待调试版本的流量分配
   将需要调试的App Engine版本分配至少1%的流量，也可以在Debugger界面手动指定应用版本号，无需将全量流量切换到该版本。

4. 确认Cloud Debugger API已启用
   在GCP控制台的「API和服务」页面搜索Cloud Debugger API，确认服务处于启用状态，未启用的话手动开启后重新部署应用即可。

5. 排查应用启动日志
   进入Cloud Logging页面，过滤App Engine对应版本的启动日志，搜索cdbg或debugger关键词，确认Debugger代理是否有初始化报错，比如权限不足、端口占用等问题，根据报错信息针对性修复。

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