spring.datasource.hikari.read-only 不是控制连接只读的正确方式,它仅在连接池初始化时尝试设置只读,不保证 JDBC 连接实际只读;真正生效的是 Connection.setReadOnly(true),需通过自定义 DelegatingDataSource 强制调用,同时配合事务传播控制(如 Propagation.NOT_SUPPORTED)和连接池参数优化。

spring.datasource.hikari.read-only 不是控制连接只读的正确方式——它只影响 HikariCP 内部连接池的初始化行为,不保证 JDBC 连接实际以只读模式打开。真正生效的是 Connection.setReadOnly(true),而 Spring Boot 默认不会自动调用它。
为什么 spring.datasource.hikari.read-only=true 多数情况下没用?
spring.datasource.hikari.read-only=true 多数情况下没用?这个配置项仅在 HikariCP 创建连接时,**尝试**将连接设为只读(取决于驱动是否支持、数据库是否允许)。但 MySQL 8+、PostgreSQL 等主流驱动中,它常被忽略或需配合其他参数才起效。实测中即使设了该值,SELECT 语句仍可能触发隐式事务,甚至被数据库拒绝(如某些只读副本强制禁止写操作时反而报错)。
- MySQL 驱动需额外加
&useSSL=false&serverTimezone=UTC&readOnly=true到 URL 才可靠生效 - PostgreSQL 驱动需在 URL 中显式加
?readonly=true - Hikari 的
read-only属性不传递给底层驱动,只是“建议”,不可依赖
推荐做法:用 DataSource 包装器强制只读连接
DataSource 包装器强制只读连接最稳妥的方式是自定义一个 DelegatingDataSource,重写 getConnection() 方法,在每次获取连接后立即调用 setReadOnly(true):
public class ReadOnlyDataSource extends DelegatingDataSource {
public ReadOnlyDataSource(DataSource targetDataSource) {
super(targetDataSource);
}
<pre class="brush:php;toolbar:false;">@Override
public Connection getConnection() throws SQLException {
Connection conn = super.getConnection();
conn.setReadOnly(true);
return conn;
}
@Override
public Connection getConnection(String username, String password) throws SQLException {
Connection conn = super.getConnection(username, password);
conn.setReadOnly(true);
return conn;
}
}
然后在配置类中替换默认 DataSource:
@Bean
@Primary
@ConditionalOnMissingBean(name = "readOnlyDataSource")
public DataSource readOnlyDataSource(@Qualifier("hikariDataSource") DataSource ds) {
return new ReadOnlyDataSource(ds);
}
- 适用于所有 JDBC 驱动,不依赖 URL 参数或连接池实现
- 避免因驱动版本差异导致只读失效(比如 MySQL 5.1 vs 8.0 对
readOnlyURL 参数处理不一致) - 注意:若业务代码里手动调用了
conn.setReadOnly(false),会覆盖此设置
SQL 视图场景下必须关闭自动事务
Spring Boot 默认启用 @Transactional 传播机制,哪怕只是查视图,也可能开启事务——这对只读副本很危险(可能阻塞复制、触发主从切换误判)。必须显式禁用:
- 在查询视图的 Service 方法上加
@Transactional(propagation = Propagation.NOT_SUPPORTED) - 或全局配置
spring.jpa.properties.hibernate.connection.provider_disables_autocommit=true(JPA 场景) - 如果用
JdbcTemplate,确保不包裹在@Transactional方法内,否则DataSourceTransactionManager会强行绑定事务
连接池参数要适配只读负载
只读数据源通常并发高、单次响应快,HikariCP 默认配置(如 connection-timeout=30000、max-lifetime=1800000)并不最优:
- 降低
connection-timeout到2000,快速失败,避免线程卡在等待连接上 - 增大
maximum-pool-size(比如从 10 → 50),应对高并发查询 - 关闭
leak-detection-threshold(只读场景极少连接泄漏,开它反而增加 GC 压力) - 禁用
isolate-internal-queries和allow-pool-suspension,减少只读路径上的开销
关键点在于:只读不是加个配置就完事,而是从连接创建、事务行为、连接池策略三个层面协同控制。最容易被忽略的是事务传播——哪怕数据源本身只读,一个没加 NOT_SUPPORTED 的 Service 方法,照样会让只读库扛住事务日志压力。











