mybatis

mybatis/spring-boot-starter

MyBatis integration with Spring Boot

4.2kstars 1.8kforks 37contributors Java

README.md

# MyBatis integration with Spring Boot

[![Java CI](https://github.com/mybatis/spring-boot-starter/actions/workflows/ci.yaml/badge.svg)](https://github.com/mybatis/spring-boot-starter/actions/workflows/ci.yaml)
[![Coverage Status](https://coveralls.io/repos/github/mybatis/spring-boot-starter/badge.svg?branch=master)](https://coveralls.io/github/mybatis/spring-boot-starter?branch=master)
[![Maven Central](https://img.shields.io/maven-central/v/org.mybatis.spring.boot/mybatis-spring-boot?label=maven%20central)](https://central.sonatype.com/artifact/org.mybatis.spring.boot/mybatis-spring-boot)
[![Docs](https://img.shields.io/badge/docs-mybatis.org-blue?logo=github)](https://mybatis.org/spring-boot-starter/)
[![License](https://img.shields.io/:license-apache-brightgreen.svg)](https://www.apache.org/licenses/LICENSE-2.0.html)

![mybatis-spring](https://mybatis.org/images/mybatis-logo.png)

MyBatis Spring-Boot-Starter will help you to use [MyBatis](https://github.com/mybatis/mybatis-3) with [Spring Boot](https://github.com/spring-projects/spring-boot)

## Requirements

* master : MyBatis 3.5, MyBatis-Spring 4.1, Java 17+ and Spring Boot 4.1
* 4.0.x : MyBatis 3.5, MyBatis-Spring 4.0, Java 17+ and Spring Boot 4.0
* 3.0.x : MyBatis 3.5, MyBatis-Spring 3.0, Java 17+ and Spring Boot 3.2-3.5
* 2.3.x : MyBatis 3.5, MyBatis-Spring 2.1, Java 8+ and Spring Boot 2.7

## Compatibility Check

* Compatibility with Spring Boot 2.7 - 4.0 [here](https://github.com/kazuki43zoo/mybatis-spring-boot-dev-compatibility-checker)

## Creating new project via Spring Initializr

* https://start.spring.io/#!dependencies=mybatis

## Essentials

### Published documentations

* [See the docs](http://www.mybatis.org/spring-boot-starter/mybatis-spring-boot-autoconfigure)
* [See the docs for testing](http://www.mybatis.org/spring-boot-starter/mybatis-spring-boot-test-autoconfigure)

### Snapshot documentations

* [See the docs](https://github.com/mybatis/spring-boot-starter/blob/master/mybatis-spring-boot-autoconfigure/src/site/markdown/index.md)
* [See the docs for testing](https://github.com/mybatis/spring-boot-starter/blob/master/mybatis-spring-boot-test-autoconfigure/src/site/markdown/index.md)

Translations:

* [See the docs(简体中文)](https://github.com/mybatis/spring-boot-starter/blob/master/mybatis-spring-boot-autoconfigure/src/site/zh_CN/markdown/index.md)
* [See the docs for testing(简体中文)](https://github.com/mybatis/spring-boot-starter/blob/master/mybatis-spring-boot-test-autoconfigure/src/site/zh_CN/markdown/index.md)

## Quick Start

* [See the wiki page](https://github.com/mybatis/spring-boot-starter/wiki/Quick-Start)

## Quick Start for building native image

* [See the wiki page](https://github.com/mybatis/spring-boot-starter/wiki/Quick-Start-for-building-native-image)

## Bug report & Feature request

* [GitHub Issue Tracker](https://github.com/mybatis/spring-boot-starter/issues)

## Question

* [Google Groups(Mailing list)](https://groups.google.com/forum/#!forum/mybatis-user)
* [Stack Overflow](https://stackoverflow.com/questions/tagged/mybatis)

Repository info

Default branch: master
Latest version: mybatis-spring-boot-4.1.0
Created: 2015-09-25
Last activity: 2026-10-09
License: Apache-2.0
Open issues: 18
Watchers: 215

Topics

java mybatis spring-boot

Contributors

hazendaz

751 contributions

kazuki43zoo

542 contributions

renovate[bot]

363 contributions

dependabot[bot]

107 contributions

eddumelendez

73 contributions