AI Skill 大全

Spring Boot 多数据源切换排障

配置 Spring Boot 多数据源并诊断 @DS、事务、异步线程和连接池问题,定位切换失败原因并给出修复方案

功能与用途

面向使用 Baomidou dynamic-datasource 的 Spring Boot 项目,提供 starter 选择、YAML 数据源配置、@DS 路由和 @DSTransactional 使用说明。用户需要提供 Spring Boot、框架及 MyBatis-Plus 版本、注解位置、调用链和相关日志,Skill 会结合代理、自调用、事务、线程、数据源键及连接池配置,判断数据源为何未切换并给出验证步骤与修改建议。

适用场景

  • @DS 注解不生效:检查同类自调用、代理链、注解位置和数据源日志,定位为何请求回落到 primary。
  • 事务内切换数据源:分析 Spring @Transactional 与 @DSTransactional 的边界、传播行为和回滚风险。
  • 异步线程串库排查:诊断 @Async、线程池或 parallelStream 中 ThreadLocal 未传递导致的错误路由。
  • 多数据源启动配置:核对 starter、Boot 版本、驱动、连接池、primary 和数据源分组配置。

适用人群

  • Spring Boot 后端开发者
  • Java 微服务工程师
  • 负责数据库路由与读写分离的开发者
  • 排查线上数据源和事务问题的运维开发人员

使用步骤

  1. 确认 Spring Boot、框架和 ORM 版本
  2. 提供数据源配置、注解位置和调用链
  3. 开启 dynamic-datasource debug 日志
  4. 按代理、事务、线程和数据源键逐项验证
  5. 根据证据修改配置或调用方式并复测

开始使用

将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。

查看 MCP 接入说明

技术信息

分类
编程
适用工具
Codex、Claude Code、OpenClaw、Hermes Agent、国内 Agent
使用难度
进阶
版本
23904d5
最近更新
2026-11-06
文件数
7
安装包大小
自动生成 ZIP
安全检查
基础检查通过

dynamic-datasource(Baomidou 多数据源框架)使用与排障指南:基础安装、@DS/@DSTransactional 用法,以及最常见问题排查——数据源切换失败/@DS 不生效、启动报错、事务内不切换、线程与异步、连接池参数、密码加密。Use when the project depends on com.baomidou:dynamic-datasource-*-starter, or when the user asks about 数据源切换失败、@DS 不生效、多数据源配置不生效、@DSTransactional、dynamic datasource switching not working, or multi-datasource troubleshooting.

依赖与权限

  • SUPPORT

同类 Skill