Java8转Java17后GCP本地服务器线程限制报错求助

问题背景 #

将5万行代码库从Java8 runtime迁移至Java17 runtime，使用官方迁移指南提供的更新版appengine-api-1.0-sdk.jar后，部署到GCP App Engine无异常，但本地开发服务器始终报错：

Can't make API call memcache.Get in a thread that is neither the original request thread nor a thread created by ThreadManager

代码库未主动调用Memcache，推测是依赖库内部触发调用。Java8版本的本地服务器未强制执行线程来源限制，而Java17版本新增该检查后引发异常。试过GCloud CLI自带的最新版dev_appserver，以及Java8文档中的旧版归档dev_appserver，结果一致。

本地启动命令：

λ  mvn clean package appengine:run -DskipTests
λ  ./bin/google_appengine/google/appengine/tools/java/bin/dev_appserver.sh target/core-1.0.1/

已启用EE8配置，访问任意Servlet或JSP页面都会触发相同报错。

可能原因 #

1. Java17版本的App Engine本地开发服务器严格执行了线程模型规范，要求调用Memcache API的线程必须是原始请求线程，或是通过ThreadManager创建的线程，Java8版本未做此强制检查。
2. 项目依赖的第三方库或appengine-api内部隐式调用了Memcache，且线程创建未遵循App Engine的ThreadManager规范。

解决方案 #

方案1：临时禁用本地线程检查（最快绕过） #

在启动本地开发服务器时添加JVM参数，关闭Memcache的线程来源检查：

• 用Maven命令启动时：

mvn clean package appengine:run -DskipTests -Dappengine.devserver.jvmArgs="-Dcom.google.appengine.api.memcache.disableThreadChecks=true"

• 用dev_appserver.sh脚本启动时：

./bin/google_appengine/google/appengine/tools/java/bin/dev_appserver.sh --jvm_flag="-Dcom.google.appengine.api.memcache.disableThreadChecks=true" target/core-1.0.1/

该参数仅作用于本地开发环境，不会影响部署到GCP的生产实例。

方案2：定位并修复隐式调用源 #

如果需要彻底解决而非临时绕过，可以开启详细日志定位触发Memcache调用的代码：

1. 创建logging.properties文件，添加以下配置：

com.google.appengine.api.memcache.level=FINEST
java.util.logging.ConsoleHandler.level=FINEST
java.util.logging.ConsoleHandler.formatter=java.util.logging.SimpleFormatter

2. 启动时指定日志配置：

# Maven方式
mvn clean package appengine:run -DskipTests -Dappengine.devserver.jvmArgs="-Djava.util.logging.config.file=logging.properties"

# 脚本方式
./bin/google_appengine/google/appengine/tools/java/bin/dev_appserver.sh --jvm_flag="-Djava.util.logging.config.file=logging.properties" target/core-1.0.1/

3. 根据日志找到触发调用的依赖库后，检查是否有适配Java17的更新版本，或替换为不依赖Memcache的替代方案。

方案3：规范线程创建方式（若能修改相关代码） #

如果能定位到创建线程的代码，将线程创建改为使用App Engine的ThreadManager：

import com.google.appengine.api.ThreadManager;

// 替换原线程创建逻辑
Thread backgroundThread = ThreadManager.createBackgroundThread(() -> {
    // 原线程执行的业务逻辑
});
backgroundThread.start();

通过ThreadManager创建的线程会被本地服务器认可，允许调用Memcache API。

验证 #

应用上述任意方案后，重新启动本地开发服务器，访问Servlet或JSP页面，确认报错日志是否消失。

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