SpringBoot中怎么切換主從數據源

SpringBoot中怎么切換主從數據源，相信很多沒有經驗的人對此束手無策，為此本文總結了問題出現的原因和解決方法，通過這篇文章希望你能解決這個問題。

SpringBoot主從數據源切換

1.原理

借助spring的【org.springframework.jdbc.datasource.lookup.AbstractRoutingDataSource】這個抽象類實現，來進行·數據源的路由，并通過Aop 進行路由選擇。

2.配置主從數據源

# dev server
# 多數據源時，主數據源為 master
spring.datasource.master.jdbc-url=jdbc:mysql://localhost:3306/epoint?characterEncoding=utf8&allowMultiQueries=true&useSSL=false&autoReconnect=true&failOverReadOnly=false
spring.datasource.master.username=test
spring.datasource.master.password=test

# dev server
# 多數據源時，從數據源為 slave
spring.datasource.slave.jdbc-url=jdbc:mysql://localhost:3306/epoint2?characterEncoding=utf8&allowMultiQueries=true&useSSL=false&autoReconnect=true&failOverReadOnly=false
spring.datasource.slave.username=test
spring.datasource.slave.password=test

啟動報錯處理

spring boot ：error querying database. Cause: java.lang.IllegalArgumentException: dataSource or dataSourceClassName or jdbcUrl is required
配置多個數據源啟動報錯，error querying database. Cause: java.lang.IllegalArgumentException: dataSource or dataSourceClassName or jdbcUrl is required，
主要原因是在1.0 配置數據源的過程中主要是寫成：spring.datasource.url 和spring.datasource.driverClassName。
而在2.0升級之后需要變更成：spring.datasource.jdbc-url和spring.datasource.driver-class-name即可解決！
更改配置：spring.datasource.master.url  ->  spring.datasource.master.jdbc-url

3.獲取當前線程的數據源類型

/**
 * describe:定義HandleDataSource類來獲取當前線程的數據源類型
 * current user Maochao.zhu
 * current system 2020/9/15
 */
public class HandleDataSource {
    public static final ThreadLocal<String> holder = new ThreadLocal<String>();

    /**
     * 綁定當前線程數據源
     *
     * @param datasource
     */
    public static void putDataSource(String datasource) {
        holder.set(datasource);
    }

    /**
     * 獲取當前線程的數據源
     *
     * @return
     */
    public static String getDataSource() {
        return holder.get();
    }

}

3.1線程沖突問題

注意：因為新加了數據庫線程處理類，和原來存在的多線程處理類沖突，會造成現有程序“卡頓”或者“死機”，因此去除原來配置的定時任務多線程配置

/**
 * describe:配置多線程定時器
 * current user Maochao.zhu
 * current system 2020/1/20
 */
@Configuration
@EnableScheduling
public class ScheduleConfig implements SchedulingConfigurer {
    @Override
    public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
        Method[] methods = BatchProperties.Job.class.getMethods();
        int defaultPoolSize = 3;
        int corePoolSize = 0;
        if (methods != null && methods.length > 0) {
            for (Method method : methods) {
                Scheduled annotation = method.getAnnotation(Scheduled.class);
                if (annotation != null) {
                    corePoolSize++;
                }
            }
            if (defaultPoolSize > corePoolSize)
                corePoolSize = defaultPoolSize;
        }
        taskRegistrar.setScheduler(Executors.newScheduledThreadPool(corePoolSize));
    }
}

4.定義路由數據源的實現類

/**
 * describe:定義路由數據源的實現類MyAbstractRoutingDataSource
 * current user Maochao.zhu
 * current system 2020/9/15
 */
public class MyAbstractRoutingDataSource extends AbstractRoutingDataSource {
    private final Logger log = LoggerFactory.getLogger(this.getClass());
    @Override
    protected Object determineCurrentLookupKey() {
        log.info("###請求的數據源：{}",HandleDataSource.getDataSource());
        return HandleDataSource.getDataSource();//獲取對應的數據源
    }
}

5.配置數據源和路由

/**
 * describe:配置數據源數據源和路由配置
 * current user Maochao.zhu
 * current system 2020/9/15
 */
@Configuration
public class DataSourceConfig {
    //主數據源
    @Bean()
    @ConfigurationProperties(prefix = "spring.datasource.master")
    public DataSource MasterDataSource() {
        return DataSourceBuilder.create().build();
    }
    //從數據源
    @Bean()
    @ConfigurationProperties(prefix = "spring.datasource.slave")
    public DataSource SlaveDataSource() {
        return DataSourceBuilder.create().build();
    }
    /**
     * 設置數據源路由，通過該類中的determineCurrentLookupKey決定使用哪個數據源
     */
    @Bean
    public AbstractRoutingDataSource routingDataSource() {
        MyAbstractRoutingDataSource proxy = new MyAbstractRoutingDataSource();
        Map<Object, Object> targetDataSources = new HashMap<>(2);//存放對于數據源的映射
        targetDataSources.put("master", MasterDataSource());
        targetDataSources.put("slave", SlaveDataSource());
        proxy.setDefaultTargetDataSource(MasterDataSource());
        proxy.setTargetDataSources(targetDataSources);
        return proxy;
    }


    @Bean(name = "SqlSessionFactory")
    @Primary
    public SqlSessionFactory MasterSqlSessionFactory(DataSource routingDataSource) throws Exception {
        SqlSessionFactoryBean bean = new SqlSessionFactoryBean();
        bean.setDataSource(routingDataSource);//DataSource使用路由數據源

        ResourcePatternResolver resolver = new PathMatchingResourcePatternResolver();
        try {
            bean.setMapperLocations(resolver.getResources("classpath*:mapper/**/*.xml"));
            bean.setConfigLocation(resolver.getResource("classpath:mybatis-config.xml"));
            return bean.getObject();
        } catch (Exception e) {
            e.printStackTrace();
            throw new RuntimeException(e);
        }

    }

    @Bean(name = "TransactionManager")
    @Primary
    public DataSourceTransactionManager testTransactionManager(DataSource routingDataSource) {
        return new DataSourceTransactionManager(routingDataSource);
    }

    @Bean(name = "SqlSessionTemplate")
    @Primary
    public SqlSessionTemplate MasterSqlSessionTemplate(SqlSessionFactory sqlSessionFactory) throws Exception {
        return new SqlSessionTemplate(sqlSessionFactory);
    }
}

5.1啟動權限shiro問題

注意：配置路由設置后，原來的apache.shiro 權限讀取不到問題，排查以后確定原因是在使用配置路由設置,原來在application.properties中配置的mybaits屬性,將不起作用，因此需要新加一個配置文件(mybatis-config.xml),從中讀取配置信息， 其中ShiroConfig配置類中新增注解支持

/**
 * 開啟Shiro的注解(如@RequiresRoles,@RequiresPermissions),需借助SpringAOP掃描使用Shiro注解的類,并在必要時進行安全邏輯驗證
 * 配置以下兩個bean(DefaultAdvisorAutoProxyCreator和AuthorizationAttributeSourceAdvisor)即可實現此功能
 * @return
 */
@Bean
@ConditionalOnMissingBean
public DefaultAdvisorAutoProxyCreator defaultAdvisorAutoProxyCreator(){
	DefaultAdvisorAutoProxyCreator advisorAutoProxyCreator = new DefaultAdvisorAutoProxyCreator();
	advisorAutoProxyCreator.setProxyTargetClass(true);
	return advisorAutoProxyCreator;
}

/**
 * 開啟shiro aop注解支持.
 * 使用代理方式;所以需要開啟代碼支持;
 * @param securityManager
 * @return
 * */
@Bean
public AuthorizationAttributeSourceAdvisor authorizationAttributeSourceAdvisor(SecurityManager securityManager){
	AuthorizationAttributeSourceAdvisor authorizationAttributeSourceAdvisor = new AuthorizationAttributeSourceAdvisor();
	authorizationAttributeSourceAdvisor.setSecurityManager(securityManager);
	return authorizationAttributeSourceAdvisor;
}

6.加載mybatis配置

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <settings>
        <setting name="cacheEnabled" value="true" />
        <setting name="lazyLoadingEnabled" value="true" />
        <setting name="multipleResultSetsEnabled" value="true" />
        <setting name="useColumnLabel" value="true" />
        <setting name="useGeneratedKeys" value="false" />
        <setting name="defaultExecutorType" value="SIMPLE" />
        <setting name="mapUnderscoreToCamelCase" value="true" />
        <setting name="logImpl" value="STDOUT_LOGGING" />
    </settings>
</configuration>

7.新建注解來注釋使用的數據源

/**
 * describe:DataSource注解來注釋Mapper接口所要使用的數據源
 * current user Maochao.zhu
 * current system 2020/9/15
 */
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface DataSource {
    String value();//設置數據源類型
}

8.配置Aop

/**
 * describe:配置Aop切換路由選擇
 * current user Maochao.zhu
 * current system 2020/9/15
 */
@Aspect
@Component
public class DataSourceAspect {
    public Logger logger = LoggerFactory.getLogger(this.getClass());
    /**
     * 在dao層方法獲取datasource對象之前，在切面中指定當前線程數據源
     */
    @Pointcut("execution(* com.cn.zx.dao..*.*(..))")//切點為所有的mapper接口
    public void pointcut() {

    }

    @Before("pointcut()")
    public void before(JoinPoint point) {
        System.out.println("before");
        Object target = point.getTarget();
        String method = point.getSignature().getName();
        Class<?>[] classz = target.getClass().getInterfaces();// 獲取目標類的接口， 所以@DataSource需要寫在接口上
        Class<?>[] parameterTypes = ((MethodSignature) point.getSignature()).getMethod().getParameterTypes();
        try {
            Method m = classz[0].getMethod(method, parameterTypes);
            if (m != null && m.isAnnotationPresent(DataSource.class)) {
                DataSource data = m.getAnnotation(DataSource.class);
                System.out.println("####################用戶選擇數據庫庫類型：" + data.value());
                HandleDataSource.putDataSource(data.value());// 數據源放到當前線程中
            }
            logger.info("執行接口方法:{}.{}", point.getSignature().getDeclaringTypeName(), point.getSignature().getName());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

9.設置數據源類型

在對應的mapper方法上使用注解DataSource("master/slave")來設置數據源類型

/**
 * 調用主數據源 master
 * @param user
 * @return
 */
@DataSource("master")
Integer insertUser(User user);

/**
 * 調用從數據源 slave
 * @param user
 * @return
 */
@DataSource("slave")
List<User> getUserList(User user);

10.事務失效問題

添加主從數據庫以后，事務就失效了，原因還在找 ,初步定位為： 事務和切面的執行順序問題 @EnableTransactionManagement(order = 2) @Order(2)

解決：

SpringbootApplication啟動類增加注解開啟事務注解,數據庫表引擎更改為innodb，如果是myisam，事務是不起作用的
@EnableTransactionManagement

事務的管理方式有兩種： 第一種:編程式事務管理，需要將數據庫的自動提交等取消，并且需要自己編寫事務代碼。 第二種:聲明式事務管理模式，spring利用spring AOP特性編寫了注解。

10.1@Transactional注解的特性

1.service類標簽(一般不建議在接口上)上添加@Transactional，可以將整個類納入spring事務管理，在每個業務方法執行時都會開啟一個事務，不過這些事務采用相同的管理方式。并且當在某個service實現類中某個方法調用了另一個這個實現類中的方法，則兩個方法都必須聲明事務，才能被當成一個事務進行管理
2.@Transactional 注解只能應用到 public 可見度的方法上。 如果應用在protected、private或者 package可見度的方法上，也不會報錯，不過事務設置不會起作用。
3.默認情況下，spring會對unchecked異常進行事務回滾；如果是checked異常則不回滾。

10.2checked異常

那么什么是checked異常，什么是unchecked異常 java里面將派生于Error或者RuntimeException（比如空指針，1/0）的異常稱為unchecked異常，其他繼承自java.lang.Exception得異常統稱為Checked Exception，如IOException、TimeoutException等，通俗一點：你寫代碼出現的空指針等異常，會被回滾，文件讀寫，網絡出問題，spring就沒法回滾了。

10.3只讀事務

@Transactional(propagation=Propagation.NOT_SUPPORTED,readOnly=true) 
只讀標志只在事務啟動時應用，否則即使配置也會被忽略。 
啟動事務會增加線程開銷，數據庫因共享讀取而鎖定(具體跟數據庫類型和事務隔離級別有關)。通常情況下，僅是讀取數據時，不必設置只讀事務而增加額外的系統開銷。

10.4事務傳播模式

Propagation枚舉了多種事務傳播模式，部分列舉如下：
1. REQUIRED(默認模式)：業務方法需要在一個容器里運行。如果方法運行時，已經處在一個事務中，那么加入到這個事務，否則自己新建一個新的事務。
2. NOT_SUPPORTED：聲明方法不需要事務。如果方法沒有關聯到一個事務，容器不會為他開啟事務，如果方法在一個事務中被調用，該事務會被掛起，調用結束后，原先的事務會恢復執行。
3. REQUIRESNEW：不管是否存在事務，該方法總匯為自己發起一個新的事務。如果方法已經運行在一個事務中，則原有事務掛起，新的事務被創建。
4. MANDATORY：該方法只能在一個已經存在的事務中執行，業務方法不能發起自己的事務。如果在沒有事務的環境下被調用，容器拋出例外。
5. SUPPORTS：該方法在某個事務范圍內被調用，則方法成為該事務的一部分。如果方法在該事務范圍外被調用，該方法就在沒有事務的環境下執行。
6. NEVER：該方法絕對不能在事務范圍內執行。如果在就拋例外。只有該方法沒有關聯到任何事務，才正常執行。
7. NESTED：如果一個活動的事務存在，則運行在一個嵌套的事務中。如果沒有活動事務，則按REQUIRED屬性執行。它使用了一個單獨的事務，這個事務擁有多個可以回滾的保存點。內部事務的回滾不會對外部事務造成影響。它只對DataSourceTransactionManager事務管理器起效。

10.5解決Transactional注解不回滾

1. 檢查你方法是不是public的。
2. 你的異常類型是不是unchecked異常。空指針異常是unchecked異常,如果我想check異常也想回滾怎么辦，注解上面寫明異常類型即可。
@Transactional(rollbackFor={Exception.class.RuntimeException.class})
類似的還有norollbackFor，自定義不回滾的異常。如果已經在service中進行了try catch 操作,由于已經被抓獲異常,事務也不會回滾
3. 數據庫引擎要支持事務，如果是mysql，注意表要使用支持事務的引擎，比如innodb，如果是myisam，事務是不起作用的。
4. 是否開啟了對注解的解析
	4.1 SpringMVC中開啟：
		<tx:annotation-driven transaction-manager="transactionManager" proxy-target-class="true"/>
	4.2 pringboot中開啟：
		啟動類增加注解：@EnableTransactionManagement
		類方法中增加注解：@Transactional
5. spring是否掃描到你這個包，如下是掃描到org.test下面的包
	<context:component-scan base-package="org.test" ></context:component-scan>

10.6數據庫引擎設置

mysql數據庫引擎innodb設置

10.6.1查看支持的引擎

show engines;

10.6.2查看默認引擎

show variables like 'default_storage_engine';

10.6.3修改默認引擎

修改mysql 默認的數據庫引擎
在配置文件my.ini中的 [mysqld] 下面加入default-storage-engine=INNODB
如果啟動不起來,找到 skip-innodb 項，將其改為 #skip-innodb（要不然知識修改了 InnoDB 服務起不來）
重啟Mysql服務器,設置生效。

10.6.4修改數據表引擎

如數據庫名為： epoint,修改數據庫表引擎從 MyISAM -> InnoDB

10.6.5查詢所有表狀態

SHOW TABLE STATUS FROM epoint;

10.6.6查詢修改表引擎的SQL

SELECT GROUP_CONCAT(CONCAT( 'ALTER TABLE ' ,TABLE_NAME ,' ENGINE=InnoDB; ') SEPARATOR '' ) 
FROM information_schema.TABLES AS t 
WHERE TABLE_SCHEMA = 'epoint' AND TABLE_TYPE = 'BASE TABLE';

10.6.7得到SQL執行

ALTER TABLE branch ENGINE=InnoDB;

10.6.8查詢所有表狀態

SHOW TABLE STATUS FROM epoint;

修改所有數據庫表的引擎為InnoDB結束

11.主從數據庫同步問題

主從數據庫數據同步問題定位： 1.程序同步。 2.數據庫操作同步數據 因為要讀寫分離，肯定要設置數據庫權限，主數據庫可以讀寫，從數據庫只能讀，所以這個方法行不通，只能從數據庫方面進行設置主從數據同步。

1.查看mysql的安裝路徑

通過mysql命令查看mysql的安裝路徑：

select @@basedir as basePath from dual;
SELECT @@basedir;

獲取路徑：C:\Program Files\MySQL\MySQL Server 5.7\

2.配置主數據庫

在my.ini 文件中找到[mysqld] 添加如下配置（需要同步的數據庫有多少都可以寫進去，主從同步會根據庫名稱找到對應的叢庫去同步數據）

server-id=1#主庫和從庫需要不一致
log-bin=mysql-bin
binlog-do-db=mstest#同步的數據庫
binlog-ignore-db=mysql#不需要同步的數據庫

2.1重啟MySql 服務,查詢主庫狀態

mysql> SHOW VARIABLES LIKE 'server_id';
+---------------+-------+
| Variable_name | Value |
+---------------+-------+
| server_id     | 1     |
+---------------+-------+
1 row in set

mysql> show master status;
+------------------+----------+--------------+------------------+-------------------+
| File             | Position | Binlog_Do_DB | Binlog_Ignore_DB | Executed_Gtid_Set |
+------------------+----------+--------------+------------------+-------------------+
| mysql-bin.000007 |     5138 | epoint       |                  |                   |
+------------------+----------+--------------+------------------+-------------------+
1 row in set

2.2為從庫創建賬號,賦值所有權限

grant all on *.* to 'user'@'%' identified by 'user';

3.配置從數據庫

在my.ini 文件中找到[mysqld] 添加如下配置（需要同步的數據庫有多少都可以寫進去，主從同步會根據庫名稱找到對應的叢庫去同步數據）

server-id=2#和主庫不一致
replicate-do-db=test#需要同步的庫1
replicate-ignore-db=mysql#不需要同步的庫

3.1啟動從庫復制功能

STOP SLAVE; #停止從復制功能的命令
change master to master_host='127.0.0.1',master_port=3306,master_user='slave',master_password='123',master_log_file='mysql-bin.000004',master_log_pos=717;

說明 ： 對應著改成 你們自己的配置，master_host：主庫的ip,master_port:主庫的端口,master_user:主庫給叢庫建立的賬號名稱,master_password:賬號密碼 關于master_log_file 和 Position（'mysql-bin.000005' 98） 是主庫配置中的"show master status"得到的;

START SLAVE; #啟動從復制功能
RESET SLAVE; #重置從復制功能的配置，會清除 master.info 和 relay-log.info 兩個文件
show slave status;   (沒有分號)，查看

其中Slave_IO_Running和Slave_SQL_Running屬性打開，表示開啟

Slave_IO_Running: Yes
Slave_SQL_Running: Yes

配置MySQL主從數據庫結束

12.參考博客信息

> 主從Mysql數據庫同步：https://blog.csdn.net/fengrenyuandefz/article/details/89420201
> 一臺電腦裝兩個MySQL：https://blog.csdn.net/weixin_41953055/article/details/79820221
> server_uuid重復：https://blog.csdn.net/sunbocong/article/details/81634296
> mysql主從同步 binlog-do-db replicate-do-db： https://blog.csdn.net/z69183787/article/details/70183284
> mysql主從數據庫同步：https://blog.csdn.net/fengrenyuandefz/article/details/89420201

看完上述內容，你們掌握SpringBoot中怎么切換主從數據源的方法了嗎？如果還想學到更多技能或想了解更多相關內容，歡迎關注億速云行業資訊頻道，感謝各位的閱讀！