1. 为什么需要分层架构当你第一次接触SpringBoot项目时可能会被各种层级的代码搞得晕头转向。为什么不能把所有代码都写在一个文件里为什么要分成Controller、Service、Mapper这么多层这就像盖房子不能把所有东西都堆在一个房间一样合理的分层能让你的代码更易维护当数据库表结构变化时你只需要修改Mapper层不需要动业务逻辑更易测试可以单独测试Service层的业务逻辑不用启动整个Web容器更易协作前后端开发者可以并行工作只需约定好接口格式我在实际项目中见过一个反例所有SQL都写在Controller里结果需求变更时要改20多个文件。而合理的分层后同样的变更只需要改2个文件。2. 用户管理系统实战设计让我们以用户管理系统为例设计一个典型的分层结构src/main/java ├── com.example.user │ ├── config # 配置类 │ ├── controller # API接口层 │ ├── service # 业务逻辑层 │ │ ├── impl # 服务实现 │ ├── mapper # 数据访问层 │ ├── model # 数据模型 │ │ ├── dto # 数据传输对象 │ │ ├── entity # 数据库实体 │ │ └── vo # 视图对象 └── resources ├── mapper # MyBatis映射文件这种结构看起来复杂但实际开发中会带来巨大便利。比如当需要添加用户权限功能时你清楚地知道该在哪个目录下新建文件。3. 从数据库到API的完整实现3.1 实体层(Entity)设计首先设计用户表对应的实体类这里推荐使用Lombok简化代码Data TableName(sys_user) public class User { TableId(type IdType.AUTO) private Long id; private String username; private String password; private String email; TableField(fill FieldFill.INSERT) private LocalDateTime createTime; TableField(fill FieldFill.UPDATE) private LocalDateTime updateTime; }几个关键点TableName指定对应的数据库表名TableId标记主键IdType.AUTO表示自增TableField的fill属性可以实现自动填充3.2 Mapper层实现MyBatis-Plus可以极大简化Mapper代码public interface UserMapper extends BaseMapperUser { // 自定义复杂查询 Select(SELECT * FROM sys_user WHERE email LIKE %#{domain}) ListUser selectByEmailDomain(String domain); }BaseMapper已经提供了基本的CRUD方法你只需要添加特殊查询即可。我建议复杂查询还是写在XML里更清晰。3.3 Service层业务封装Service层应该体现业务逻辑而不是直接暴露数据库操作public interface UserService { UserDTO createUser(CreateUserDTO dto); PageUserVO queryUsers(UserQuery query); } Service RequiredArgsConstructor public class UserServiceImpl implements UserService { private final UserMapper userMapper; Override Transactional public UserDTO createUser(CreateUserDTO dto) { if (userMapper.existsByUsername(dto.getUsername())) { throw new BusinessException(用户名已存在); } User user new User(); BeanUtils.copyProperties(dto, user); user.setPassword(encodePassword(dto.getPassword())); userMapper.insert(user); return convertToDTO(user); } }注意这里使用了DTO进行层间数据传输避免实体类直接暴露给前端。3.4 Controller层API设计Controller应该保持精简只处理HTTP相关逻辑RestController RequestMapping(/users) RequiredArgsConstructor public class UserController { private final UserService userService; PostMapping public ResultUserDTO createUser(Valid RequestBody CreateUserDTO dto) { return Result.success(userService.createUser(dto)); } GetMapping public ResultPageUserVO queryUsers(UserQuery query) { return Result.success(userService.queryUsers(query)); } }4. 分层开发中的常见陷阱4.1 贫血模型问题很多项目中的Entity只有getter/setter这被称为贫血模型。更好的做法是将相关行为封装到实体中public class User { // ... 字段定义 public void changePassword(String oldPass, String newPass) { if (!matchPassword(oldPass)) { throw new IllegalStateException(旧密码错误); } this.password encodePassword(newPass); } }4.2 跨层调用问题绝对不要出现Controller直接调用Mapper的情况这会导致业务逻辑无处安放。正确的调用链应该是Controller - Service - Mapper4.3 循环依赖问题如果UserService调用OrderService而OrderService又需要调用UserService就会形成循环依赖。解决方案提取公共逻辑到第三个Service使用事件驱动架构将部分逻辑下沉到领域对象中5. 进阶技巧DTO与MapStruct随着项目复杂度的提升你会发现实体类与DTO之间的转换代码非常冗长。这时候可以使用MapStruct自动生成映射代码Mapper public interface UserConverter { UserConverter INSTANCE Mappers.getMapper(UserConverter.class); Mapping(source createTime, target registerDate) UserDTO toDTO(User user); } // 使用方式 UserDTO dto UserConverter.INSTANCE.toDTO(user);MapStruct会在编译时生成实现类性能远高于反射实现的BeanUtils。6. 测试策略分层架构的一个巨大优势是便于测试Mapper层使用MyBatis Test或直接集成测试Service层Mockito模拟依赖进行单元测试Controller层MockMvc模拟HTTP请求WebMvcTest(UserController.class) class UserControllerTest { Autowired private MockMvc mockMvc; MockBean private UserService userService; Test void shouldCreateUser() throws Exception { when(userService.createUser(any())).thenReturn(new UserDTO()); mockMvc.perform(post(/users) .contentType(MediaType.APPLICATION_JSON) .content({\username\:\test\})) .andExpect(status().isOk()); } }7. 项目结构优化建议当项目规模扩大后可以按功能模块进一步拆分com.example ├── module1 │ ├── controller │ ├── service │ └── mapper └── module2 ├── controller └── service每个模块可以独立打包通过maven或gradle管理依赖关系。