在云原生架构日益普及的今天，Amazon RDS（关系型数据库服务）凭借其高可用、易扩展的特性，成为众多企业的首选。为了应对高并发读写场景，RDS提供了只读副本（Read Replica）功能，允许将读流量分散到多个副本节点，从而减轻主库压力。然而，对于Spring Boot开发者而言，如何正确配置读写分离连接、确保事务一致性，并找到开箱即用的示例代码，一直是颇具挑战的课题。本文将从实践角度出发，梳理关键配置要点，并推荐若干GitHub开源项目，助你快速落地。
一、为何需要只读副本连接？
传统单体应用中，数据库往往只有一个连接端点。当业务量激增，主库的CPU、IO容易成为瓶颈。RDS只读副本允许创建最多15个异步复制的只读实例，适用于报表查询、数据分析等读密集型场景。Spring Boot应用通过数据源路由，可将写操作发送至主库，读操作分发至副本，实现负载均衡。
但需要注意：副本与主库之间存在秒级复制延迟。若应用强依赖“读己所写”的实时一致性（例如下单后立即查询订单状态），则不宜将读请求路由到副本。常见解决方案是设置“事务内读主库”策略，或对关键查询强制走主库。
二、Spring Boot配置读写分离的几种方式
1. 基于AbstractRoutingDataSource手动路由
Spring框架提供了AbstractRoutingDataSource抽象类，允许根据当前线程上下文动态选择数据源。开发者可以定义主库和副本的数据源，并通过AOP或注解在Service层切换数据源。此方法灵活度高，但需要自行处理事务同步、重复代码等细节。
2. 集成Spring Cloud AWS或AWS JDBC Driver
AWS官方提供了aws-advanced-jdbc-wrapper（原Amazon Web Services JDBC Driver），支持读写分离、故障转移等高级功能。只需在application.properties中配置集群端点即可：
spring.datasource.url=jdbc:aws-wrapper:mysql://your-cluster.cluster-xxx.us-east-1.rds.amazonaws.com:3306/db
spring.datasource.driver-class-name=software.amazon.jdbc.Driver
该驱动会自动识别主库与副本，并根据SQL类型（SELECT/INSERT等）路由。但需要额外引入Maven依赖，并配置IAM或密码认证。
3. 使用第三方库如shardingsphere-jdbc
Apache ShardingSphere的JDBC模块提供了完善的数据分片、读写分离功能。配置简单，支持自定义负载均衡算法（轮询、随机、延迟最小等）。对于已有Spring Boot项目，只需引入shardingsphere-jdbc-core并编写YAML配置文件即可。
三、关键注意事项
- 事务边界：若方法被
@Transactional标记，建议强制使用主库，避免副本读到的数据滞后。可通过@Transactional(readOnly = true)标注只读事务，并利用AOP自动路由到副本。 - 连接池配置：建议为主库和副本分别配置独立的HikariCP连接池，防止一个副本故障影响整个连接池。
- 健康检查：定期检测副本的复制延迟，延迟过高时应自动降级到主库。AWS RDS提供了
ReplicaLag监控指标，可在应用端通过CloudWatch API获取。 - 密码与IAM：若使用IAM数据库认证，需配置AWS SDK凭证，并生成临时令牌。AWS JDBC Driver原生支持此流程。
四、GitHub上的优质示例项目
以下开源仓库提供了完整的Spring Boot + RDS读写分离实现，可直接克隆学习：
-
aws-samples/aws-aurora-springboot-read-replica
GitHub地址：https://github.com/aws-samples/aws-aurora-springboot-read-replica
官方示例，展示如何使用Spring Boot + Aurora集群实现读写分离，包含使用Spring Cloud AWS和直接JDBC两种方式，附有详细的CloudFormation部署模板。 -
shardingsphere/shardingsphere-readwrite-splitting
GitHub地址：https://github.com/apache/shardingsphere/tree/master/examples/shardingsphere-jdbc-example
Apache ShardingSphere官方示例模块，演示基于YAML配置的读写分离，支持MySQL、PostgreSQL，可轻松替换为RDS连接。 -
spring-projects/spring-data-jpa-examples
GitHub地址：https://github.com/spring-projects/spring-data-jpa-examples
非直接RDS示例，但其中multi-datasource示例展示了如何配置多个数据源，可作为手动路由的起点。 -
aws/aws-advanced-jdbc-wrapper
GitHub地址：https://github.com/awslabs/aws-advanced-jdbc-wrapper
AWS官方JDBC驱动，提供读写分离、集群故障转移等功能，文档中包含Spring Boot配置案例。
五、总结
实现Spring Boot与RDS读写副本的高效连接，核心在于选择合适的数据源路由策略，并妥善处理复制延迟与事务一致性。对于中小型项目，推荐优先使用AWS JDBC Driver或Spring Cloud AWS，因为它们无需额外维护路由逻辑。若需要更复杂的定制（如根据用户维度路由），则可选用ShardingSphere或自行扩展AbstractRoutingDataSource。
建议读者参考上述GitHub仓库中的示例，结合自身业务场景进行调整。最后提醒：生产环境中务必做好监控与熔断，确保主库故障时读流量能平滑切换至剩余副本——这才是真正的高可用。