解决 “Cannot read SQL script from class path resource [sql/XX.sql]“ 错误

这个错误表明你的应用程序无法从类路径(classpath)中找到 sql/init.sql 文件。以下是可能的原因和解决方案

常见原因及解决方案

文件位置不正确

确保你的 init.sql 文件确实位于 src/main/resources/sql/ 目录下(对于 Maven/Gradle 项目)。

检查点:

1.对于 Maven 项目:src/main/resources/sql/init.sql

2.对于 Gradle 项目:src/main/resources/sql/init.sql

资源路径引用错误

确保你使用的路径与实际位置匹配:

复制代码
// 正确的引用方式
new ClassPathResource("sql/init.sql")

如果文件直接在 resources 根目录下,应该使用:

复制代码
new ClassPathResource("init.sql")

构建工具未包含资源文件

检查构建配置:

对于 Maven:

复制代码
<build>
  <resources>
    <resource>
      <directory>src/main/resources</directory>
    </resource>
  </resources>
</build>

对于 Gradle:

复制代码
sourceSets {
  main {
    resources {
      srcDirs = ["src/main/resources"]
    }
  }
}

文件编码问题

确保 SQL 文件使用正确的编码(通常 UTF-8)。

文件权限问题

检查文件是否有读取权限。

调试步骤

验证文件是否存在:

复制代码
ClassPathResource resource = new ClassPathResource("sql/init.sql");
System.out.println("文件存在: " + resource.exists());

列出类路径内容检查:

复制代码
InputStream is = getClass().getResourceAsStream("/sql");
// 或者检查整个类路径

检查构建输出目录,确认文件是否被正确复制:

Maven: target/classes/sql/init.sql

Gradle: build/resources/main/sql/init.sql

替代方案

如果问题仍然存在,可以尝试:

使用绝对路径(不推荐,仅用于测试):
复制代码
new FileSystemResource("src/main/resources/sql/init.sql")
使用 Spring Boot 的自动配置:
复制代码
# application.properties
spring.datasource.schema=classpath:sql/init.sql
相关推荐
晚风_END3 小时前
Linux|操作系统|最新版openzfs编译记录
linux·运维·服务器·数据库·spring·中间件·个人开发
dLYG DUMS3 小时前
DBeaver连接本地MySQL、创建数据库表的基础操作
数据库·mysql
kumat4 小时前
分享-搭建个人系统 MySelfSys
sql·系统
苍煜4 小时前
MySQL分库分表和ES到底怎么选?
数据库·mysql·elasticsearch
茉莉玫瑰花茶4 小时前
Qt 信号与槽 [ 1 ]
开发语言·数据库·qt
czlczl200209255 小时前
松散索引扫描/跳跃索引扫描
数据库·mysql·性能优化
星马梦缘6 小时前
数据库作战记录 实验7、8
数据库·sql·oracle
安逸sgr7 小时前
Hermes Agent + Obsidian 打造第二大脑(六):分层记忆系统的设计逻辑——L0/L1/L2/L3 四层记忆详解
数据库·agent·知识库·hermes·hermesagent
苍煜7 小时前
一篇讲懂分库分表:概念、spirngboot实战
数据库·oracle
梦想画家7 小时前
PostgreSQL 物化视图实战:从数据固化到智能刷新的全链路指南
数据库·postgresql·物化视图