2023 Java后端开发标准配置：Spring Boot 3 + MyBatis-Plus + MySQL-代码聚汇网

2023 Java后端开发标准配置：Spring Boot 3 + MyBatis-Plus + MySQL

南瓜丶奇迹师·2026-08-14·阅读 24 GEO检测（免费）

Java后端开发Spring Boot 3MyBatis-Plus

|难度：普通|阅读约 21 分钟

1. 项目概述：现代Java后端开发的标准配置

在2023年的Java后端开发领域，这套技术组合已经成为事实上的行业标准配置。Spring Boot 3作为基础框架，提供了现代化的应用开发体验；MyBatis-Plus在数据持久层显著提升了开发效率；MySQL作为最流行的开源关系型数据库；Swagger则解决了API文档的自动化生成问题。

这套配置特别适合以下场景：

快速启动的企业级应用开发
需要同时兼顾开发效率和性能的中型项目
前后端分离架构下的后端服务开发
需要完善API文档管理的团队协作项目

提示：虽然这些组件都能独立工作，但它们的协同配置中有许多值得注意的细节。我在多个生产项目中验证过这套配置的稳定性，特别是在高并发场景下的表现。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 环境准备与基础配置

2.1 开发环境要求

在开始之前，请确保你的开发环境满足以下要求：

JDK 17或更高版本（Spring Boot 3的最低要求）
Maven 3.6.3+或Gradle 7.x
MySQL 8.0+（推荐使用8.0.28以上版本）
IDE推荐IntelliJ IDEA 2022.3+

2.2 初始化Spring Boot项目

使用Spring Initializr创建项目时，需要选择以下依赖：

xml复制<dependencies>
    <!-- Spring Boot基础 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    
    <!-- 数据库相关 -->
    <dependency>
        <groupId>com.mysql</groupId>
        <artifactId>mysql-connector-j</artifactId>
        <scope>runtime</scope>
    </dependency>
    <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>mybatis-plus-boot-starter</artifactId>
        <version>3.5.3.1</version>
    </dependency>
    
    <!-- 文档生成 -->
    <dependency>
        <groupId>org.springdoc</groupId>
        <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
        <version>2.1.0</version>
    </dependency>
    
    <!-- 开发工具 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-devtools</artifactId>
        <scope>runtime</scope>
        <optional>true</optional>
    </dependency>
</dependencies>

注意：Spring Boot 3默认使用Jakarta EE 9+，这意味着所有javax.包名都已改为jakarta.。如果你遇到包导入错误，请检查是否使用了正确的包路径。

3. 核心配置文件详解

3.1 application.yml基础配置

标准的配置文件应该包含以下部分：

yaml复制server:
  port: 8080
  servlet:
    context-path: /api

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/your_database?useSSL=false&serverTimezone=UTC&characterEncoding=UTF-8
    username: root
    password: yourpassword
    hikari:
      maximum-pool-size: 20
      minimum-idle: 5
      idle-timeout: 30000
      max-lifetime: 1800000
      connection-timeout: 30000

  jackson:
    date-format: yyyy-MM-dd HH:mm:ss
    time-zone: GMT+8

mybatis-plus:
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
  global-config:
    db-config:
      id-type: auto
      logic-delete-field: deleted
      logic-delete-value: 1
      logic-not-delete-value: 0

springdoc:
  swagger-ui:
    path: /swagger-ui.html
    tags-sorter: alpha
    operations-sorter: alpha
  api-docs:
    path: /v3/api-docs
  group-configs:
    - group: 'default'
      paths-to-match: '/**'
      packages-to-scan: com.your.package

3.2 关键配置解析

数据库连接池配置：
HikariCP是Spring Boot默认的连接池，生产环境中需要根据服务器配置调整：

maximum-pool-size = CPU核心数 * 2 + 有效磁盘数
对于SSD存储，可以适当增加maximum-pool-size

MyBatis-Plus全局配置：

id-type: auto 表示使用数据库自增ID
逻辑删除配置可以让开发者无需手动处理删除状态

Swagger配置要点：

使用springdoc-openapi替代传统的springfox，后者已停止维护
paths-to-match和packages-to-scans需要根据你的项目结构调整

4. MyBatis-Plus高级配置

4.1 分页插件配置

在配置类中添加分页插件：

java复制@Configuration
public class MybatisPlusConfig {
    
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 分页插件
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
        // 乐观锁插件
        interceptor.addInnerInterceptor(new OptimisticLockerInnerInterceptor());
        return interceptor;
    }
}

4.2 自动填充功能

实现元对象处理器来处理自动填充字段：

java复制@Component
public class MyMetaObjectHandler implements MetaObjectHandler {
    
    @Override
    public void insertFill(MetaObject metaObject) {
        this.strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now());
        this.strictInsertFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
    }

    @Override
    public void updateFill(MetaObject metaObject) {
        this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
    }
}

4.3 枚举类型处理

MyBatis-Plus提供了优雅的枚举处理方式：

java复制@Getter
public enum UserStatus {
    ENABLED(1, "启用"),
    DISABLED(0, "禁用");
    
    private final int code;
    private final String desc;
    
    UserStatus(int code, String desc) {
        this.code = code;
        this.desc = desc;
    }
}

// 在实体类中使用
public class User {
    private UserStatus status;
}

5. Swagger集成与优化

5.1 基础API文档配置

创建Swagger配置类：

java复制@Configuration
public class SwaggerConfig {

    @Bean
    public OpenAPI springShopOpenAPI() {
        return new OpenAPI()
                .info(new Info().title("API文档")
                        .description("项目接口文档")
                        .version("v1.0")
                        .contact(new Contact().name("开发者").email("dev@example.com")))
                .externalDocs(new ExternalDocumentation()
                        .description("项目Wiki")
                        .url("https://wiki.example.com"));
    }
}

5.2 接口分组与权限控制

对于大型项目，可能需要按模块分组展示API：

yaml复制springdoc:
  group-configs:
    - group: '用户模块'
      paths-to-match: '/user/**'
      packages-to-scan: com.example.module.user
    - group: '订单模块'
      paths-to-match: '/order/**'
      packages-to-scan: com.example.module.order

5.3 生产环境安全配置

在生产环境中，应该限制Swagger的访问：

java复制@Profile("!prod")
@Configuration
public class SwaggerConfig {
    // 配置内容同上
}

然后在生产环境配置中禁用Swagger：

yaml复制spring:
  profiles: prod
springdoc:
  swagger-ui:
    enabled: false
  api-docs:
    enabled: false

6. 常见问题与解决方案

6.1 MySQL连接问题

时区问题：
确保连接URL中包含serverTimezone=UTC参数。在中国区可以使用serverTimezone=Asia/Shanghai

SSL警告：
开发环境可以添加useSSL=false，生产环境应该配置正确的SSL证书

6.2 MyBatis-Plus常见异常

Table not found：
检查实体类上的@TableName注解，或者确认数据库表是否创建

字段映射错误：

确认数据库字段命名风格（下划线转驼峰是默认行为）
可以使用@TableField注解显式指定字段映射

6.3 Swagger无法访问

404错误：

检查springdoc.swagger-ui.path配置
确认没有拦截Swagger相关路径的安全过滤器

空白页面：

可能是静态资源路径问题，尝试清除浏览器缓存
检查是否有CORS配置阻止了Swagger UI加载资源

7. 性能优化建议

7.1 数据库连接池调优

根据实际负载调整HikariCP参数：

yaml复制spring:
  datasource:
    hikari:
      maximum-pool-size: 50
      minimum-idle: 10
      idle-timeout: 60000
      max-lifetime: 1800000
      connection-timeout: 30000
      connection-test-query: SELECT 1

7.2 MyBatis-Plus二级缓存

启用MyBatis二级缓存可以显著提升查询性能：

yaml复制mybatis-plus:
  configuration:
    cache-enabled: true

然后在Mapper接口上添加@CacheNamespace注解：

java复制@CacheNamespace
public interface UserMapper extends BaseMapper<User> {
}

7.3 Swagger生产环境策略

对于高并发生产环境：

使用@Profile("dev")限制Swagger只在开发环境启用
考虑使用单独的文档服务器托管API文档
对于微服务架构，可以集中部署Swagger UI并通过网关聚合各服务API

8. 项目结构最佳实践

推荐的标准项目结构：

code复制src/main/java
└── com
    └── example
        └── demo
            ├── config       # 配置类
            ├── controller   # 控制器
            ├── entity       # 实体类
            ├── enums        # 枚举类型
            ├── mapper       # Mapper接口
            ├── service      # 服务层
            │   ├── impl     # 服务实现
            ├── util         # 工具类
            └── DemoApplication.java

关键实践：

实体类放在entity包中
Mapper接口放在mapper包中，与XML文件对应
服务接口与实现分离
配置类统一放在config包中

9. 日志配置补充

虽然这不是核心配置的一部分，但完善的日志系统对项目至关重要。推荐使用Logback的配置：

xml复制<!-- src/main/resources/logback-spring.xml -->
<configuration>
    <property name="LOG_PATH" value="./logs"/>
    <property name="APP_NAME" value="your-application"/>
    
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
        </encoder>
    </appender>
    
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_PATH}/${APP_NAME}.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <fileNamePattern>${LOG_PATH}/${APP_NAME}-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
            <maxFileSize>50MB</maxFileSize>
            <maxHistory>30</maxHistory>
            <totalSizeCap>1GB</totalSizeCap>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
        </encoder>
    </appender>
    
    <root level="INFO">
        <appender-ref ref="CONSOLE"/>
        <appender-ref ref="FILE"/>
    </root>
    
    <!-- MyBatis日志 -->
    <logger name="com.example.demo.mapper" level="DEBUG"/>
</configuration>

10. 测试配置建议

完善的测试配置能显著提升开发效率：

java复制@SpringBootTest
@ActiveProfiles("test")
@AutoConfigureMockMvc
class DemoApplicationTests {
    
    @Autowired
    private MockMvc mockMvc;
    
    @Test
    void contextLoads() {
    }
    
    @Test
    void testGetUser() throws Exception {
        mockMvc.perform(get("/user/1"))
               .andExpect(status().isOk())
               .andExpect(jsonPath("$.name").value("test"));
    }
}

测试环境专用配置：

yaml复制# src/test/resources/application-test.yml
spring:
  datasource:
    url: jdbc:h2:mem:testdb
    driver-class-name: org.h2.Driver
    username: sa
    password:
    hikari:
      maximum-pool-size: 10
      
  sql:
    init:
      mode: always
      schema-locations: classpath:schema.sql
      data-locations: classpath:data.sql

这套配置在实际项目中已经验证过多次，特别是在快速迭代的开发场景中表现优异。根据我的经验，最大的价值点在于MyBatis-Plus和Swagger的配合使用，可以节省约40%的CRUD开发时间，同时保持代码的可维护性。