官方网站：https://xbatis.cn * 文档：https://deepwiki.com/xbatis/xbatis * GitHub：https://github.com/xbatis/xbatis

你是否也有这些痛点？

• 项目有 50 个实体，就要写 50 个 Mapper 接口，重复代码让人崩溃
• 多表联查写一堆 XML，改个字段名全局搜索替换，还容易漏
• 多租户、逻辑删除、乐观锁……每个功能都要手写拦截器，费时费力
• 读写分离配置复杂，运行时切换数据源更是噩梦 如果你用过 MyBatis，这些问题一定不陌生。Xbatis 正是为解决这些痛点而生。

Xbatis 是什么？

Xbatis 是一个基于 MyBatis 的增强框架，定位是"少写 SQL、链式 DSL、跨数据库兼容"。 它的核心理念只有一句话：对 MyBatis 只做封装，不做侵入式改造。这意味着你原有的 MyBatis 代码、XML、插件全部可以继续使用，Xbatis 只是在上面加了一层优雅的壳。

核心特性一览

1. 链式 DSL：写查询像写英语

传统 MyBatis 写多表联查，你需要写 XML、手动拼接条件、手动处理结果映射。用 Xbatis，同样的查询变成这样：

SysUserRoleVo vo = QueryChain.of(sysUserMapper)
.select(SysUser.class, SysRole.class)
.from(SysUser.class)
.join(SysUser::getRoleId, SysRole::getId)
.eq(SysUser::getId, 1)
.like(SysUser::getUserName, "abc")
.groupBy(SysUser::getId)
.having(SysUser::getId, c -> c.count().gt(0))
.orderBy(SysUser::getId)
.returnType(SysUserRoleVo.class)
.get();

全程 Lambda 方法引用，字段名拼错了编译直接报错，IDE 自动补全，重构无忧。

2. 单 Mapper 模式：一个接口搞定所有实体

传统项目 100 个实体 = 100 个 Mapper 接口。Xbatis 的单 Mapper 模式让你只需定义一个：

// 定义一次
public interface MybatisBasicMapper extends BasicMapper {}
// 全局注册
XbatisGlobalConfig.setSingleMapperClass(MybatisBasicMapper.class);

mybatisBasicMapper.save(new SysUser());
mybatisBasicMapper.deleteById(SysUser.class, 1);
QueryChain.of(mybatisBasicMapper, SysUser.class)
.eq(SysUser::getId, 1)
.list();

@Table
public class SysUser {
@TableId
private Integer id;
@TenantId // 多租户自动隔离
private Long tenantId;
@LogicDelete(beforeValue = "0", afterValue = "1")
@LogicDeleteTime // 逻辑删除 + 删除时间
private Integer deleted;
@Version // 乐观锁
private Integer version;
}

try (LogicDeleteSwitch ignored = LogicDeleteSwitch.with(false)) {
mapper.getById(1); // 此处可查到已删除记录
}

@DS("slave") // 查询走从库
List<SysUser> list = mapper.list(...);
@DS("master") // 写入走主库
void save(SysUser user);

@XbatisPojoCheckScan(basePackages = "com.example.project.pojo")
public class ApiApplication { ... }

<dependency>
<groupId>cn.xbatis groupId>
<artifactId>xbatis-spring-boot3-starter artifactId>
<version>1.9.9-M7 version>
dependency>

@Data

@Table
public class SysUser {
@TableId
private Integer id;
private String userName;
private String password;
private Integer roleId;
private LocalDateTime createTime;
}

public interface SysUserMapper extends MybatisMapper<SysUser> {}

第四步：开始使用

@Service
public class UserService {
@Autowired
private SysUserMapper sysUserMapper;
public Pager<SysUser> search(String name, int page) {
return QueryChain.of(sysUserMapper)
.like(SysUser::getUserName, name)
.paging(Pager.of(page, 10));
}
}

就这么简单。

与同类框架对比

适合哪些场景？

• 中大型 Spring Boot 项目：单 Mapper 模式大幅减少重复代码
• 多租户 SaaS 平台：租户隔离完全透明，无需业务代码介入
• 需要读写分离的系统：动态数据源路由开箱即用
• AI 辅助开发场景：方法引用 + 类型安全 + 启动检查，AI 生成的代码更可靠

结语

Xbatis 不是要替代 MyBatis，而是让 MyBatis 用起来更爽。它保留了 MyBatis 的所有灵活性，同时补齐了工程化开发中最常见的痛点。

如果你正在寻找一个轻量、高性能、功能完备的 MyBatis 增强方案，不妨给 Xbatis 一个机会。

GitHub：https://github.com/xbatis/xbatis 官方文档：https://xbatis.cn