f you want an embedded database (H2, HSQL or Derby), please put it on the classpath. If you have database settings to be loaded from a particular profile you may need to activate it (no profiles are currently active).

### 嵌入式数据库未在classpath中的解决方案 Spring Boot 应用程序启动时报告 `embedded database not on classpath` 的错误通常是因为应用程序无法找到所需的嵌入式数据库驱动程序（如 H2、HSQL 或 Derby）。以下是可能的原因以及对应的解决方法： #### 1. **缺少依赖项** 如果希望使用嵌入式数据库（例如 H2），则需要将其作为 Maven 或 Gradle 项目的依赖项显式引入。如果没有正确配置这些依赖项，则会触发此错误。 对于 H2 数据库，可以在 `pom.xml` 文件中添加以下依赖项： ```xml <dependency> <groupId>com.h2database</groupId> <artifactId>h2</artifactId> <scope>runtime</scope> </dependency> ``` 或者，在 `build.gradle` 中添加如下内容： ```gradle implementation 'com.h2database:h2' ``` 这一步确保了嵌入式数据库的驱动程序被加载到类路径中[^1]。 --- #### 2. **数据源 URL 配置缺失** 即使添加了嵌入式数据库的依赖项，但如果未正确指定 `spring.datasource.url` 属性，仍然会出现类似的错误提示。可以通过修改 `application.properties` 来设置默认的数据源连接字符串。例如，针对 H2 数据库可以这样配置： ```properties spring.datasource.platform=h2 spring.datasource.driver-class-name=org.h2.Driver spring.datasource.url=jdbc:h2:mem:testdb spring.datasource.username=sa spring.datasource.password=password ``` 上述配置指定了内存模式下的 H2 数据库实例，并提供了用户名和密码以便访问[^2]。 --- #### 3. **激活特定环境配置文件** 当 Spring Boot 使用多环境配置时，默认情况下不会自动启用任何活动配置文件。因此，如果有专门用于开发或测试阶段的数据库设置（存储于 `application-dev.properties` 等文件中），需通过命令行参数或其他方式手动激活对应 Profile。 例如，运行应用时可附加 JVM 参数 `-Dspring.profiles.active=dev` 启动开发环境；或者直接编辑 `application.properties` 添加如下条目以预设活动状态： ```properties spring.profiles.active=dev ``` 此时，系统将优先读取与该 Profile 关联的部分定义好的属性值[^3]。 --- #### 4. **外部 MySQL 替代方案** 假如实际需求并非采用内置型 DBMS 而是外接传统关系型数据库比如 MySQL，则同样要记得声明相应的 JDBC Connector 并调整相关初始化脚本位置等细节。下面是一个例子展示如何切换至 MySQL 实例： ```properties spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver spring.datasource.url=jdbc:mysql://localhost:3306/my_database_name?serverTimezone=UTC&useSSL=false spring.datasource.username=my_user_account spring.datasource.password=my_secure_password ``` 注意这里还涉及到了 timezone 和 SSL 设置选项，视具体场景而定是否必要加入额外参数[^4]。 --- ### 总结 综上所述，解决 “Embedded Database Not On ClassPath” 错误的关键在于确认三点：一是检查 pom.xml 或 build.gradle 是否已导入目标 RDBMS 扩展包；二是核实 application.*props* 文件里关于 Datasource 的各项字段填写无误；三是依据实际情况决定要不要开启某个特殊 profile 下独占版别的设定集。