App Engine Java8迁Java11出现ApiProxy$CallNotFoundException错误咨询

问题根因 #

该报错是App Engine Java 11 二代运行时的线程约束与Cloud Debugger默认代理逻辑不兼容导致：

• Java 8 一代运行时允许Cloud Debugger后台线程直接调用urlfetch内置API
• Java 11 二代运行时强制要求所有App Engine内置API（含urlfetch）的调用，仅能在原生请求线程、或ThreadManager创建的线程中执行，Cloud Debugger默认查询GCE元数据的后台线程不符合该约束，因此每10秒尝试注册调试端时就会抛出对应异常，同时导致调试器找不到目标应用。

可选解决方案 #

方案1：快速关闭Cloud Debugger（优先推荐，立即消除日志报错） #

如果当前不需要使用Cloud Debugger功能，直接在配置中关闭内置代理即可：

• 若使用app.yaml配置，添加如下环境变量：

env_variables:
  DISABLE_CLOUD_DEBUGGER: "true"

• 若使用appengine-web.xml配置，添加如下节点：

<env-entries>
  <env-entry>
    <env-entry-name>DISABLE_CLOUD_DEBUGGER</env-entry-name>
    <env-entry-type>java.lang.String</env-entry-type>
    <env-entry-value>true</env-entry-value>
  </env-entry>
</env-entries>

修改配置后重新部署应用，报错即可消失。

方案2：手动适配保留Cloud Debugger功能 #

如果必须使用Cloud Debugger，需要替换默认内置的代理，手动集成适配二代运行时的版本：

• 引入最新版的Cloud Debugger Java依赖
• 自定义Debugger的线程工厂，使用ThreadManager.currentRequestThreadFactory()创建后台查询线程，符合App Engine的线程调用约束。

方案3：临时替代调试方案 #

也可以暂时用Cloud Logging自定义埋点、本地远程连接staging实例调试的方式替代内置Cloud Debugger，等待官方修复该适配问题后再切回默认配置。

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