解释jdbc:mysql://localhost:3306/${spring.datasource.database}?useSSL=false&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull

### 配置 Spring Boot 的 MySQL 数据源 在 Spring Boot 项目中，可以通过 `application.properties` 或 `application.yml` 文件来配置 MySQL 数据源的相关参数。以下是具体的配置方法： #### 使用 application.properties 进行配置 可以在 `application.properties` 文件中添加如下内容以完成数据源的配置[^1]： ```properties spring.datasource.url=jdbc:mysql://localhost:3306/your_database_name?useSSL=false&serverTimezone=UTC spring.datasource.username=your_username spring.datasource.password=your_password spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver ``` - **spring.datasource.url**: 表示数据库连接地址。其中 `jdbc:mysql://` 是协议头，`localhost` 是主机名，`:3306` 是端口号，`your_database_name` 是目标数据库名称。附加参数如 `useSSL=false` 和 `serverTimezone=UTC` 可用于解决 SSL 认证和时区兼容性问题。 - **spring.datasource.username**: 数据库用户名。 - **spring.datasource.password**: 数据库密码。 - **spring.datasource.driver-class-name**: 显式指定 JDBC 驱动程序类名。不过通常情况下可以省略此字段，因为 Spring Boot 能够自动从 URL 推导驱动器类名[^3]。 #### 使用 application.yml 进行配置 如果偏好 YAML 格式的配置文件，则可在 `application.yml` 中定义相同的内容[^2]: ```yaml spring: datasource: url: jdbc:mysql://localhost:3306/your_database_name?useSSL=false&serverTimezone=UTC username: your_username password: your_password driver-class-name: com.mysql.cj.jdbc.Driver hikari: maximum-pool-size: 10 ``` 上述配置中的 `hikari.maximum-pool-size` 属性是用来调整 HikariCP 连接池的最大大小，默认值可能不足以满足高并发需求，因此可以根据实际场景进行优化。 #### 验证 Driver 是否可用 为了确保应用程序能正常运行，在启动阶段会尝试加载所指定的驱动程序类 (例如 `com.mysql.cj.jdbc.Driver`)。如果没有显式提供该属性，Spring Boot 将基于所提供的 URL 自动检测并加载合适的驱动程序。 ### 注意事项 当使用较新的 MySQL Connector/J 版本时，请注意其包路径已更改为 `com.mysql.cj.jdbc.Driver`，而非旧版本中的 `com.mysql.jdbc.Driver`。这一步骤对于避免潜在错误至关重要。

### 关于'Spring Boot MyBatis-Plus SQLNonTransientConnectionException Public Key Retrieval Is Not Allowed' 当在 Spring Boot 中集成 MyBatis-Plus 并尝试连接到 MySQL 数据库时，如果遇到 `SQLNonTransientConnectionException` 错误提示 `'Public Key Retrieval is not allowed'`，这通常是因为 JDBC 驱动程序试图验证服务器的公钥，而此操作未被显式允许。 以下是可能的原因以及解决方案： #### 原因分析 该错误的根本原因在于 MySQL 的 SSL/TLS 连接配置。MySQL 客户端驱动默认会启用公共密钥检索功能 (publicKeyRetrieval=true)，但在某些情况下，这种行为可能会引发异常。这是因为客户端无法通过标准方式获取服务器的 RSA 密钥[^1]。 --- #### 解决方案 可以通过调整数据库连接 URL 或者修改应用程序中的数据源配置来解决问题。 ##### 方法一：禁用 PublicKey Retrieval 功能 最简单的解决方法是在数据库连接字符串中设置参数 `allowPublicKeyRetrieval=false` 和 `useSSL=false`。这样可以完全关闭公钥检索和 SSL 加密的功能。 更新后的连接 URL 可能如下所示： ```properties spring.datasource.url=jdbc:mysql://localhost:3306/your_database?serverTimezone=UTC&useSSL=false&allowPublicKeyRetrieval=false ``` 这里的关键部分是添加了两个额外的参数： - **useSSL=false**: 禁用了 SSL 连接。 - **allowPublicKeyRetrieval=false**: 显式地禁用了公钥检索机制[^2]。 --- ##### 方法二：提供正确的公钥文件路径 如果你希望保留安全性并继续使用公钥检索，则需要确保提供了有效的公钥证书。可以在连接 URL 中指定公钥位置或者将其嵌入到 Java 应用程序的信任存储区中。 例如，在连接 URL 中加入以下选项： ```properties spring.datasource.url=jdbc:mysql://localhost:3306/your_database?serverTimezone=UTC&useSSL=true&clientCertificateKeyStoreUrl=file:/path/to/client-cert.p12&clientCertificateKeyStorePassword=secret ``` 这种方法适用于更高级的安全需求场景，但对于大多数开发环境来说并不常见[^3]。 --- ##### 方法三：升级 MySQL Connector/J 版本 有时问题可能是由于使用的 MySQL 驱动版本较旧而导致的行为不一致。建议检查当前项目的依赖项，并考虑将 MySQL Connector/J 升级至最新稳定版。 Maven 依赖示例： ```xml <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.33</version> <!-- 替换为最新的兼容版本 --> </dependency> ``` 注意：不同版本之间可能存在 API 差异，请仔细阅读官方文档以确认更改的影响[^4]。 --- ##### 方法四：调试日志排查 为了进一步定位问题根源，可开启详细的 JDBC 日志记录以便观察具体的通信过程。只需向 application.properties 文件增加下面几行即可激活相关跟踪信息： ```properties logging.level.com.zaxxer.hikari=DEBUG logging.level.org.springframework.jdbc.core=DEBUG logging.level.mysql.connector.j=FINEST ``` 这些日志可以帮助识别是否存在其他潜在因素干扰正常运行状态下的数据库交互流程[^5]。 --- ### 示例代码片段 假设我们正在构建一个基于 Spring Boot 和 MyBatis-Plus 的应用，完整的 configuration 属性定义应类似于下述形式： ```yaml spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/test_db?serverTimezone=UTC&useSSL=false&allowPublicKeyRetrieval=false username: root password: your_password_here mybatis-plus: mapper-locations: classpath*:mapper/*.xml type-aliases-package: com.example.demo.entity ``` 以上 YAML 格式的配置同样有效替代 properties 方式设定各项必要参数值[^6]。 ---