解决dynamic-datasource项目中@DS注解失效问题

在使用dynamic-datasource项目进行多数据源配置时，开发者可能会遇到@DS注解切换数据源失效的情况。本文将深入分析这一问题并提供完整的解决方案。

问题现象

当使用dynamic-datasource配置多数据源时，即使在不同方法上添加了@DS注解指定不同数据源，系统仍然只使用primary指定的默认数据源，无法实现预期的数据源切换效果。

根本原因分析

经过排查，发现导致该问题的常见原因主要有以下几点：

1. 版本不匹配：dynamic-datasource-spring-boot3-starter的版本与Spring Boot 3.x版本不兼容
2. 注解位置错误：@DS注解被错误地放置在单元测试类中，而非Service或Mapper层
3. 事务影响：某些情况下事务传播行为可能导致数据源切换失效

详细解决方案

版本兼容性问题

对于Spring Boot 3.x项目，必须使用专为Spring Boot 3设计的dynamic-datasource版本。正确的版本配置应该是：

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>dynamic-datasource-spring-boot3-starter</artifactId>
    <version>4.2.0</version>
</dependency>

注解正确用法

@DS注解必须应用在Service或Mapper层的类或方法上，而不是测试类中。以下是正确用法示例：

@Service
public class UserService {
    
    @Autowired
    private UserMapper userMapper;
    
    @DS("master")
    public User getMasterUser(String id) {
        return userMapper.selectById(id);
    }
    
    @DS("slave")
    public User getSlaveUser(String id) {
        return userMapper.selectById(id);
    }
}

事务处理建议

当方法上有@Transactional注解时，可能会影响数据源切换。建议：

1. 将@DS注解放在@Transactional之前
2. 或者考虑在事务外部进行数据源切换

配置示例

正确的YAML配置示例如下：

spring:
  datasource:
    dynamic:
      primary: master
      datasource:
        master:
          url: jdbc:mysql://localhost:3306/db1
          username: root
          password: root
          driver-class-name: com.mysql.cj.jdbc.Driver
        slave:
          url: jdbc:mysql://localhost:3306/db2
          username: root
          password: root
          driver-class-name: com.mysql.cj.jdbc.Driver

最佳实践建议

1. 始终检查版本兼容性，特别是Spring Boot大版本升级时
2. 将@DS注解应用于Service或Mapper层
3. 在复杂事务场景中，注意数据源切换的时机
4. 开发时开启SQL日志，方便验证数据源切换是否生效

通过以上解决方案，开发者可以顺利实现dynamic-datasource项目中的数据源动态切换功能。