SpringBoot中MySQL连接字符串配置

古城微笑少年丶 2023-10-11 22:07 20阅读 0赞

1.  SpringBoot中MySQL连接字符串配置样例：

spring:
      datasource:
        url: jdbc:mysql://localhost:3306/<database_name>?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=UTC&characterEncoding=UTF-8
        username: root
        password: root
        driver-class-name: com.mysql.jdbc.Driver

1.  MySQL连接字符串后面可携带的参数包括：`useUnicode`, `characterEncoding`, `autoReconnect`, `failOverReadOnly`, `maxReconnects`, `socketTimeout`, `connectTimeout`, `useCompression`, `useSSL`, `requireSSL`, `verifyServerCertificate`, `useLegacyDatetimeCode`, `serverTimezone`, `useJDBCCompliantTimezoneShift`, `useGmtMillisForDatetimes`, `dumpQueriesOnException`, `emulateUnsupportedPstmts`, `allowMultiQueries`, `poolName`, 等等。

以下是完整的MySQL连接字符串示例：

jdbc:mysql://<host>:<port>/<database_name>?useUnicode=true&characterEncoding=utf8&autoReconnect=true&failOverReadOnly=false&maxReconnects=<number>&socketTimeout=<ms>&connectTimeout=<ms>&useCompression=true/false&useSSL=true/false&requireSSL=true/false&verifyServerCertificate=true/false&useLegacyDatetimeCode=true/false&serverTimezone=<timezone>&useJDBCCompliantTimezoneShift=true/false&useGmtMillisForDatetimes=true/false&dumpQueriesOnException=true/false&emulateUnsupportedPstmts=true/false&allowMultiQueries=true/false&poolName=<pool_name>

1.  下表详细解释了MySQL连接字符串后面各个参数的用途和注意事项：

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>值</th> 
   <th>用途</th> 
   <th>注意事项</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>useUnicode</code></td> 
   <td><code>true</code>/<code>false</code></td> 
   <td>指定是否使用 Unicode 字符集。</td> 
   <td>如果不设置或设置为 false，可能会导致插入和查询出现乱码。</td> 
  </tr> 
  <tr> 
   <td><code>characterEncoding</code></td> 
   <td><code>utf8</code>/<code>gbk</code> 等</td> 
   <td>指定字符编码集。</td> 
   <td>可以根据具体情况选择合适的字符编码集。</td> 
  </tr> 
  <tr> 
   <td><code>autoReconnect</code></td> 
   <td><code>true</code>/<code>false</code></td> 
   <td>是否自动重新连接。</td> 
   <td>如果设置为 true，可能会导致系统负载过大。</td> 
  </tr> 
  <tr> 
   <td><code>failOverReadOnly</code></td> 
   <td><code>true</code>/<code>false</code></td> 
   <td>当连接指向主数据库时，如果主数据库失效，是否切换到从数据库。</td> 
   <td>主数据库故障时才使用，一般没必要设置。</td> 
  </tr> 
  <tr> 
   <td><code>maxReconnects</code></td> 
   <td>整数</td> 
   <td>设置尝试重新连接的最大次数。</td> 
   <td>连接失败后将重新尝试连接。</td> 
  </tr> 
  <tr> 
   <td><code>socketTimeout</code></td> 
   <td>毫秒数</td> 
   <td>套接字超时时间。</td> 
   <td>如果套接字超时，则连接被视为失败。</td> 
  </tr> 
  <tr> 
   <td><code>connectTimeout</code></td> 
   <td>毫秒数</td> 
   <td>连接超时时间。</td> 
   <td>如果连接超过此时间，则连接被视为失败。</td> 
  </tr> 
  <tr> 
   <td><code>useCompression</code></td> 
   <td><code>true</code>/<code>false</code></td> 
   <td>是否启用压缩。</td> 
   <td>该参数可提高数据传输效率。</td> 
  </tr> 
  <tr> 
   <td><code>useSSL</code></td> 
   <td><code>true</code>/<code>false</code></td> 
   <td>是否启用 SSL 连接。</td> 
   <td>如果数据库本身不支持 SSL 连接，则该参数设置为 true 会导致连接失败。</td> 
  </tr> 
  <tr> 
   <td><code>requireSSL</code></td> 
   <td><code>true</code>/<code>false</code></td> 
   <td>是否要求使用 SSL 连接。</td> 
   <td>只接受 SSL 连接。</td> 
  </tr> 
  <tr> 
   <td><code>verifyServerCertificate</code></td> 
   <td><code>true</code>/<code>false</code></td> 
   <td>是否验证服务器证书。</td> 
   <td>默认情况下，MySQL 不验证服务器证书。</td> 
  </tr> 
  <tr> 
   <td><code>useLegacyDatetimeCode</code></td> 
   <td><code>true</code>/<code>false</code></td> 
   <td>是否使用旧版日期时间代码。</td> 
   <td>如果设置为 true，将使用旧版的 MySQL 日期时间代码。</td> 
  </tr> 
  <tr> 
   <td><code>serverTimezone</code></td> 
   <td><code>UTC</code>/<code>GMT+8</code> 等</td> 
   <td>指定时区。</td> 
   <td>时区的设置应该与服务器所在时区相同，否则可能会影响时间戳等操作。</td> 
  </tr> 
  <tr> 
   <td><code>useJDBCCompliantTimezoneShift</code></td> 
   <td><code>true</code>/<code>false</code></td> 
   <td>是否将 Java 时间转换为 JDBC 规范的时间格式。</td> 
   <td>如果设置为 true，则将使用 JDBC 规范的时间格式。如果设置为 false，则将使用 MySQL 特定的时间格式。</td> 
  </tr> 
  <tr> 
   <td><code>useGmtMillisForDatetimes</code></td> 
   <td><code>true</code>/<code>false</code></td> 
   <td>是否使用 GMT 毫秒数作为日期时间值。</td> 
   <td>如果设置为 true，则将使用 GMT 毫秒数作为日期时间值。如果设置为 false，则将使用本地时区的绝对毫秒数。</td> 
  </tr> 
  <tr> 
   <td><code>dumpQueriesOnException</code></td> 
   <td><code>true</code>/<code>false</code></td> 
   <td>是否在异常时打印 SQL 查询语句。</td> 
   <td>只有在调试期间才需要设置为 true。默认情况下，不会打印 SQL 查询语句。</td> 
  </tr> 
  <tr> 
   <td><code>emulateUnsupportedPstmts</code></td> 
   <td><code>true</code>/<code>false</code></td> 
   <td>是否模拟不支持预处理语句的情况。</td> 
   <td>如果设置为 true，则将模拟不支持预处理语句的情况。如果设置为 false，则会尝试使用预处理语句。</td> 
  </tr> 
  <tr> 
   <td><code>allowMultiQueries</code></td> 
   <td><code>true</code>/<code>false</code></td> 
   <td>是否允许一次执行多个查询。</td> 
   <td>只有在特定的情况下才需要启用此选项。否则会增加安全风险。</td> 
  </tr> 
  <tr> 
   <td><code>poolName</code></td> 
   <td>字符串</td> 
   <td>连接池的名称。</td> 
   <td>如果使用连接池，则需要为连接池指定一个名称。</td> 
  </tr> 
 </tbody> 
</table>

注意：以上参数并非全部可用，具体应根据实际情况选择合适的参数和值。