Java Spring Boot+MySQL+Maven部署Heroku后页面报错求助

一、编译错误（invalid target release: 11）的复盘 #

你遇到的第一个错误是Heroku构建环境的JDK版本与项目指定的编译版本不匹配。解决这个问题时，除了修改pom.xml中的Java版本，还需要确保以下两点：

• 在pom.xml中明确指定java.version属性，同时配置maven-compiler-plugin的source和target版本一致：

  <properties>
      <java.version>11</java.version>
  </properties>
  
  <build>
      <plugins>
          <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-compiler-plugin</artifactId>
              <version>3.10.1</version>
              <configuration>
                  <source>${java.version}</source>
                  <target>${java.version}</target>
              </configuration>
          </plugin>
      </plugins>
  </build>
  

• 在项目根目录添加system.properties文件，指定Heroku使用的JDK版本：

  java.runtime.version=11
  

这一步确保Heroku构建和运行环境都使用对应版本的Java，避免后续版本不一致问题。

二、推送成功但页面报错的排查步骤 #

推送成功不代表应用能正常运行，按以下步骤排查：

1. 查看应用运行日志 #

这是最关键的步骤，执行命令：

heroku logs --tail

日志会显示应用启动、运行时的所有错误，比如数据库连接失败、端口配置错误、依赖缺失等，是定位问题的核心依据。

2. 确认端口配置正确 #

Heroku会动态分配端口，不能硬编码端口号。在application.properties或application.yml中设置：

server.port=${PORT:8080}

${PORT}会读取Heroku提供的环境变量，fallback值8080用于本地开发。

3. 检查MySQL数据库配置 #

Heroku上的MySQL服务（比如ClearDB add-on）会通过环境变量提供连接信息，需在配置文件中读取这些变量，而非硬编码：

# 使用ClearDB的话，直接读取官方环境变量
spring.datasource.url=${CLEARDB_DATABASE_URL}
# 如果需要拆分用户名和密码（可选）
# spring.datasource.username=${CLEARDB_USERNAME}
# spring.datasource.password=${CLEARDB_PASSWORD}

# 确保Hibernate方言适配MySQL
spring.jpa.hibernate.ddl-auto=update
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect

如果使用外部MySQL服务器，需要确保服务器允许Heroku的IP访问，并且配置SSL连接（Heroku要求外部数据库连接使用SSL）。

4. 验证应用是否成功启动 #

在日志中查找类似Started [YourApplicationName] in X seconds的日志，如果没有，说明应用启动失败，可能是：

• 依赖冲突：本地能运行但Heroku构建时依赖缺失（检查pom.xml是否有<scope>provided</scope>错误配置）
• 配置文件错误：比如数据库URL格式错误、缺少必填配置项
• 代码错误：比如启动时的初始化逻辑抛出异常

5. 排查页面访问问题 #

如果日志显示应用已启动，但页面报错（比如404、500）：

• 404：检查控制器的@RequestMapping路径是否正确，静态资源是否放在src/main/resources/static或src/main/resources/templates目录下
• 500：查看日志中的堆栈跟踪，定位具体的代码异常（比如数据库查询错误、空指针等）

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