You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Kotlin SpringBoot项目IntelliJ正常运行,Docker部署报错

问题解决:Docker部署Spring Boot Kotlin项目时缺少entityManagerFactory Bean

核心问题分析

从报错链可以看出,根本原因是Spring无法创建entityManagerFactory Bean,导致后续Repository、Service、Controller的依赖注入失败。主要诱因有以下几点:

  1. 数据库文件路径错误:后端容器无法访问SQLite数据库文件,导致JPA无法初始化连接
  2. Shadow Jar与Spring Boot自动配置冲突:自定义的Shadow Jar构建可能破坏了Spring Boot的类结构和自动配置逻辑
  3. 冗余依赖导致的类路径问题:重复引入Spring Data JPA依赖可能引发版本冲突

分步解决方案

1. 修复Docker容器间的数据库文件共享

SQLite是文件型数据库,后端容器需要和SQLite容器共享同一个数据库文件:

  • 修改docker-compose.yml,给backend服务添加SQLite卷挂载,并修正数据源URL:
version: '3'
services:
  backend:
    image: openjdk:17-alpine  # 与项目编译目标JDK版本一致,避免兼容性问题
    volumes:
      - ./Back-end:/app
      - ./sqlite:/sqlite  # 新增:共享SQLite数据库卷
    working_dir: /app
    command: sh ./run.sh
    ports:
      - "8080:8080"
    depends_on:
      - sqlite
    environment:
      - SPRING_DATASOURCE_URL=jdbc:sqlite:/sqlite/db  # 修改为共享卷的路径
      - SPRING_JPA_HIBERNATE_DDL_AUTO=update  # 可选:自动创建表结构

  sqlite:
    image: alpine:latest
    volumes:
      - ./sqlite:/sqlite
    command: sh -c "apk --no-cache add sqlite && touch /sqlite/db && sqlite3 /sqlite/db '.databases' && tail -f /dev/null"
    container_name: sqlite

2. 替换Shadow Jar为Spring Boot官方bootJar

Spring Boot自带的bootJar已经提供了完整的可执行Jar构建能力,无需额外使用Shadow Jar:

  • 修改build.gradle.kts,移除Shadow Jar相关配置,改用bootJar:
import org.jetbrains.kotlin.gradle.tasks.KotlinCompile

plugins {
    id("org.springframework.boot") version "3.2.3"
    id("io.spring.dependency-management") version "1.1.4"
    kotlin("jvm") version "1.9.22"
    kotlin("plugin.spring") version "1.9.22"
    kotlin("plugin.jpa") version "1.9.22"
    java
    // 移除Shadow Jar插件
}

group = "fr.arosaje"
version = "0.0.1-SNAPSHOT"

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

repositories {
    mavenCentral()
}

dependencies {
    implementation("org.springframework.boot:spring-boot-starter-data-jpa")
    implementation("org.springframework.boot:spring-boot-starter-web")
    implementation("com.fasterxml.jackson.module:jackson-module-kotlin")
    implementation("org.jetbrains.kotlin:kotlin-reflect")
    implementation("org.springframework.security:spring-security-crypto")
    implementation("io.jsonwebtoken:jjwt-api:0.11.2")
    implementation("io.jsonwebtoken:jjwt-impl:0.11.2")
    implementation("io.jsonwebtoken:jjwt-jackson:0.11.2")
    implementation("org.springdoc:springdoc-openapi-starter-webmvc-ui:2.3.0")
    implementation("org.xerial:sqlite-jdbc:3.44.1.0")
    implementation("org.hibernate.orm:hibernate-community-dialects:6.2.7.Final")
    // 移除冗余的spring-data-jpa依赖,已包含在starter中
    testImplementation("org.springframework.boot:spring-boot-starter-test")
}

tasks.withType<KotlinCompile> {
    kotlinOptions {
        freeCompilerArgs += "-Xjsr305=strict"
        jvmTarget = "17"
    }
}

tasks.withType<Test> {
    useJUnitPlatform()
}

// 移除Shadow Jar相关配置,改用Spring Boot的bootJar
tasks.bootJar {
    archiveClassifier.set("boot")
    mainClass.set("fr.arosaje.MainKt")
}

tasks.build {
    dependsOn(tasks.bootJar)
}

configure<org.springframework.boot.gradle.dsl.SpringBootExtension> {
    mainClass.set("fr.arosaje.MainKt")
}

3. 更新run.sh脚本以启动bootJar

修改run.sh,确保启动的是Spring Boot生成的bootJar:

#!/bin/sh
apk update && apk add findutils
./gradlew clean build
java -jar $(ls -1 build/libs/*-boot.jar | head -n 1)

4. 验证数据库连接配置

确保项目的application.properties或application.yml中包含必要的JPA配置(如果没有通过环境变量设置):

spring.datasource.driver-class-name=org.sqlite.JDBC
spring.jpa.database-platform=org.hibernate.community.dialect.SQLiteDialect
spring.jpa.hibernate.ddl-auto=update

验证步骤

  1. 清理之前的容器和构建产物:docker-compose down && rm -rf Back-end/build sqlite/db
  2. 重新启动容器:docker-compose up --build
  3. 检查日志,确认entityManagerFactory Bean成功创建,后端服务正常启动

内容的提问来源于stack exchange,提问作者MrCT_

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.26 18:59:54