解决 “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
相关推荐
NineData5 小时前
数据库迁移总踩坑?用 NineData 迁移评估,提前识别所有兼容性风险
数据库·程序员·云计算
阿里云大数据AI技术5 小时前
用 SQL 调大模型?Hologres + 百炼,让数据开发直接“对话”AI
sql·llm
赵渝强老师8 小时前
【赵渝强老师】PostgreSQL中表的碎片
数据库·postgresql
全栈老石12 小时前
拆解低代码引擎核心:元数据驱动的"万能表"架构
数据库·低代码
倔强的石头_1 天前
kingbase备份与恢复实战(二)—— sys_dump库级逻辑备份与恢复(Windows详细步骤)
数据库
jiayou642 天前
KingbaseES 实战:深度解析数据库对象访问权限管理
数据库
李广坤3 天前
MySQL 大表字段变更实践(改名 + 改类型 + 改长度)
数据库
爱可生开源社区4 天前
2026 年,优秀的 DBA 需要具备哪些素质?
数据库·人工智能·dba
随逸1775 天前
《从零搭建NestJS项目》
数据库·typescript
加号35 天前
windows系统下mysql多源数据库同步部署
数据库·windows·mysql