App Engine Runtime从Java8升级到Java11后本地运行权限错误求助

可能原因及对应解决方案 #

1. 命令参数传递错误 #

你执行的命令中-Dexec.args传入的是WAR包文件路径target/appName-1.war，但Jetty的WebAppContext若配置为读取目录而非直接加载WAR包，会尝试自动解压WAR并访问内部文件，过程中可能触发权限问题。

• 修复方式：
  修改命令参数为WAR包解压后的目录路径：

  clean install package exec:java -Dexec.args="target/appName-1"
  

  或确保Jetty代码配置支持直接加载WAR包（需保证进程有解压权限）。

2. Maven打包生成的文件权限不足 #

Mavenpackage阶段生成的target/appName-1目录或LICENSE文件权限设置过严，导致Jetty进程无法读取。

• 修复方式：
  在POM中添加maven-war-plugin配置，强制设置解压后文件和目录的权限：

  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-war-plugin</artifactId>
    <version>3.3.2</version>
    <configuration>
      <archive>
        <filePermissions>644</filePermissions>
        <directoryPermissions>755</directoryPermissions>
      </archive>
    </configuration>
  </plugin>
  

  也可手动调整权限：Windows右键目录属性修改权限；Linux/macOS执行chmod -R 755 target/appName-1。

3. ServerMain类Jetty配置有误 #

若ServerMain中WebAppContext的路径配置错误，比如错误使用相对路径、未正确设置资源基础路径，会导致权限验证失败。

• 修复方式：
  检查并修正Jetty初始化代码：

  WebAppContext webAppContext = new WebAppContext();
  // 加载WAR包的写法
  webAppContext.setWar(args[0]);
  // 或加载解压后目录的写法
  // webAppContext.setResourceBase(args[0]);
  webAppContext.setContextPath("/");
  

  同时排查代码中是否存在对LICENSE文件的特殊权限限制逻辑。

4. Windows系统UAC权限拦截（Windows环境适用） #

Windows的用户账户控制（UAC）可能限制Jetty进程访问target目录，尤其是命令提示符/IDE未以管理员身份运行时。

• 修复方式：
  以管理员身份打开命令提示符或IDE后再执行运行命令；或把项目目录迁移到非系统盘（如D盘），避开UAC权限拦截。

5. Maven exec插件配置问题 #

手动传递-Dexec.args可能导致路径参数出错，或插件运行权限受限。

• 修复方式：
  在POM中配置exec-maven-plugin，直接绑定参数，无需手动传递：

  <plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>exec-maven-plugin</artifactId>
    <version>3.1.0</version>
    <executions>
      <execution>
        <goals>
          <goal>java</goal>
        </goals>
      </execution>
    </executions>
    <configuration>
      <mainClass>com.yourpackage.ServerMain</mainClass>
      <arguments>
        <argument>${project.build.directory}/${project.build.finalName}</argument>
      </arguments>
    </configuration>
  </plugin>
  

  之后直接执行mvn clean install exec:java即可运行。

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