Spring Boot项目升级JDK17后环境识别异常求助

一、先确认当前shell的环境变量是否真的生效 #

• 执行以下命令查看当前环境变量值：

  echo $JAVA_HOME
  echo $PATH
  

  确认JAVA_HOME指向/opt/bgwadmin/java，且PATH中/opt/bgwadmin/java/bin的位置在/user/java/bin之前（系统会优先读取PATH中靠前的命令）。
• 用which java查看当前调用的java命令路径，如果输出是/user/java/bin/java，说明PATH顺序有问题或者配置未生效。
• 直接执行JDK17的java命令验证安装完整性：

  /opt/bgwadmin/java/bin/java -version
  

  如果这里能正确显示JDK17版本，说明JDK本身安装没问题，问题出在环境变量配置或加载上。

二、排查环境变量配置的持久化与加载问题 #

• 确认你修改的是当前用户登录时会加载的配置文件：
  • Bash shell：通常是~/.bashrc、~/.bash_profile或系统级的/etc/profile
  • Zsh shell：~/.zshrc
• 修改配置后必须执行source 配置文件路径让配置立即生效，比如：

  source ~/.bashrc
  

  远程登录的话，建议重新连接shell确保新配置被加载。
• 检查是否有其他脚本（比如服务启动脚本、定时任务脚本）硬编码了JAVA_HOME或java命令的绝对路径，这类配置会覆盖系统环境变量。

三、Spring Boot应用的JDK版本验证 #

• 如果是通过自定义启动脚本启动jar包，检查脚本中是否指定了固定的java路径，比如是否写了/user/java/bin/java -jar your-app.jar，这种写法会忽略系统环境变量，需要改成用$JAVA_HOME/bin/java或者直接用java（依赖环境变量）。
• 确认项目构建配置的JDK版本：
  • Maven项目（pom.xml）：确保maven-compiler-plugin的source、target、release都设置为17：

    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.11.0</version>
        <configuration>
            <source>17</source>
            <target>17</target>
            <release>17</release>
        </configuration>
    </plugin>
    

  • Gradle项目（build.gradle）：

    java {
        sourceCompatibility = JavaVersion.VERSION_17
        targetCompatibility = JavaVersion.VERSION_17
    }
    

• 查看应用启动日志，搜索类似Java version:的输出，确认是启动时使用的JDK版本问题，还是编译版本未更新的问题。

四、系统级默认JDK切换（可选） #

如果需要全局切换默认JDK，Linux系统可使用update-alternatives命令：

sudo update-alternatives --install /usr/bin/java java /opt/bgwadmin/java/bin/java 100
sudo update-alternatives --install /usr/bin/javac javac /opt/bgwadmin/java/bin/javac 100
sudo update-alternatives --config java

执行最后一条命令后，选择对应JDK17的序号，即可将系统默认JDK切换为17。

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