Spring Boot+Gradle项目启动报错：无法解析持久化单元根URL

我来帮你一步步排查和解决这个启动失败的问题——从报错信息和你的build.gradle配置来看，核心问题是依赖版本混乱、冗余依赖冲突，再加上一些配置细节错误，导致JPA的EntityManagerFactory初始化失败。

核心问题拆解 #

从报错栈和配置文件分析，主要问题集中在这几点：

1. Spring Boot版本不统一：构建脚本里的spring-boot-gradle-plugin用了1.4.0.RELEASE，但依赖里的starter组件用了1.5.6.RELEASE，还有tomcat starter用了更老的1.2.4.RELEASE，版本差异会引发大量类冲突。
2. 重复/冗余依赖：手动引入的spring-data-jpa、javax.persistence和spring-boot-starter-tomcat，其实已经被spring-boot-starter-data-jpa和spring-boot-starter-web包含，重复引入会导致版本冲突。
3. Jar/War插件配置错误：jar任务里的Main-Class路径写错了（不该包含src.main.java前缀），而且Spring Boot的war包不需要手动指定Main-Class，插件会自动处理。

分步解决方案 #

1. 统一Spring Boot版本并清理冗余依赖 #

修改你的build.gradle，统一使用兼容JDK7的Spring Boot 1.5.6.RELEASE版本，移除多余的依赖：

buildscript {
    repositories {
        mavenCentral()
    }
    dependencies {
        // 统一使用1.5.6.RELEASE，和依赖里的starter版本保持一致
        classpath("org.springframework.boot:spring-boot-gradle-plugin:1.5.6.RELEASE")
    }
}

group 'batch'
version '1.0-SNAPSHOT'

apply plugin: 'java'
apply plugin: 'spring-boot'
apply plugin: 'war'

bootRun {
    addResources = true
}

war {
    baseName = 'Batch'
    version = '0.1.0'
    // Spring Boot的war包不需要手动指定Main-Class，插件会自动生成正确配置，移除这段冗余代码
}

jar {
    manifest {
        // Main-Class只需要写全类名，不需要路径前缀
        attributes 'Main-Class': 'com.Application'
    }
}

sourceCompatibility = 1.7
targetCompatibility = 1.7

repositories {
    mavenCentral()
}

dependencies {
    compile group: 'org.springframework.boot', name: 'spring-boot-starter-web', version: '1.5.6.RELEASE'
    compile group: 'mysql', name: 'mysql-connector-java', version: '5.1.24'
    compile group: 'org.json', name: 'json', version: '20180130'
    // spring-boot-starter-data-jpa已经包含spring-data-jpa、hibernate和javax.persistence依赖，无需单独引入
    compile group: 'org.springframework.boot', name: 'spring-boot-starter-data-jpa', version: '1.5.6.RELEASE'
    compile group: 'javax.servlet', name: 'jstl', version: '1.2'
    compile group: 'org.apache.tomcat.embed', name: 'tomcat-embed-jasper', version: '7.0.82'
    // 移除以下冗余依赖：
    // - spring-boot-starter-tomcat：已被spring-boot-starter-web包含
    // - spring-data-jpa：已被spring-boot-starter-data-jpa包含
    // - javax.persistence：已被spring-boot-starter-data-jpa包含
}

2. 检查数据库与JPA配置 #

确保src/main/resources/application.properties（或application.yml）里有正确的数据库连接和JPA配置，示例如下：

# 数据库连接配置
spring.datasource.url=jdbc:mysql://localhost:3306/your_db_name?useSSL=false&characterEncoding=utf8
spring.datasource.username=your_db_user
spring.datasource.password=your_db_pwd
spring.datasource.driver-class-name=com.mysql.jdbc.Driver

# JPA基础配置
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL5Dialect

3. 确认实体类扫描范围 #

• 确保你的实体类（加了@Entity注解的类）在com.Application所在包的子包下；
• 如果实体类在其他包，需要通过@EntityScan注解指定扫描路径：

@SpringBootApplication
@EntityScan(basePackages = "com.yourpackage.entity") // 替换成你的实体类实际所在包
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

验证修复 #

执行以下步骤验证修复效果：

1. 清理构建缓存：./gradlew clean
2. 重新构建并启动项目：./gradlew bootRun
3. 如果是war包部署，执行./gradlew war后部署到Tomcat即可

这样应该就能解决持久化单元根URL无法解析的问题了。

内容的提问来源于stack exchange，提问作者Explain Down Vote