添加spring-boot-starter-data-jpa后Spring Boot应用出现404错误求助

问题根源 #

添加spring-boot-starter-data-jpa依赖后，Spring Boot的自动配置机制会触发JPA相关组件（数据源、EntityManagerFactory等）的初始化流程，但你当前未配置任何数据库连接参数（URL、用户名、密码等），导致应用启动过程中出现隐性初始化失败，最终Web上下文未完全加载，控制器的请求映射未被注册，因此访问时返回404。

哪怕你没有直接使用JPA功能，只要依赖存在，自动配置就会执行。

解决办法 #

办法1：配置数据库连接信息 #

在项目src/main/resources下创建或修改application.properties，添加MySQL连接配置：

# 替换为你的数据库名称
spring.datasource.url=jdbc:mysql://localhost:3306/your_db?useSSL=false&serverTimezone=UTC
# 数据库用户名
spring.datasource.username=root
# 数据库密码
spring.datasource.password=your_password
# Hibernate表生成策略，按需调整
spring.jpa.hibernate.ddl-auto=update
# 开启SQL日志（可选）
spring.jpa.show-sql=true

配置完成后确保MySQL服务运行，重启应用即可。

办法2：临时禁用JPA自动配置 #

如果只是需要引入JPA依赖但暂时不需要数据库连接功能，可在主类上排除相关自动配置类：

package org.example;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration;
import org.springframework.boot.autoconfigure.orm.jpa.HibernateJpaAutoConfiguration;
import org.springframework.boot.builder.SpringApplicationBuilder;
import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;

@SpringBootApplication(exclude = {
        DataSourceAutoConfiguration.class,
        HibernateJpaAutoConfiguration.class
})
public class MyWebApplication extends SpringBootServletInitializer {

    public static void main(String[] args) {
        SpringApplication.run(MyWebApplication.class, args);
    }

    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder builder){
        return builder.sources(MyWebApplication.class);
    }

}

办法3：查看启动日志定位问题 #

启动应用时仔细观察控制台输出，会看到类似如下的错误日志：

Failed to configure a DataSource: 'url' attribute is not specified and no embedded datasource could be configured.

这些日志会直接点明问题，帮助快速定位。

验证 #

修改完成后重启应用，访问http://localhost:8080，即可正常显示"Hello World, Spring Boot!"。

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