别再死记硬背了！用SpringBoot+Mybatis手撸一个Tlias员工管理系统，这才是理解分层架构的正确姿势

从零构建SpringBootMyBatis分层架构Tlias员工管理系统实战精解1. 为什么需要分层架构当你第一次完成一个SpringBoot项目时可能会产生这样的困惑为什么非要拆分成Controller、Service、Mapper这些层级直接在Controller里写SQL不是更简单吗这种困惑源于对分层架构本质理解的缺失。分层架构的核心价值在于职责分离每层只关注特定职责如Controller处理HTTP协议Service专注业务逻辑解耦复用业务逻辑可被多个Controller复用无需重复编写可维护性修改数据访问逻辑不会影响业务层代码可测试性各层可独立测试如单独测试Service逻辑实际开发中常见的反模式在Controller中直接调用Mapper这相当于把业务逻辑和接口协议耦合在一起后期维护将变得极其困难。2. Tlias项目分层结构详解2.1 标准五层架构设计Tlias采用经典的五层架构各层职责分明层级核心职责技术实现典型注解表现层(Controller)接收HTTP请求参数校验返回统一响应Spring MVCRestController业务层(Service)核心业务逻辑事务控制Spring TransactionService持久层(Mapper)数据库操作SQL映射MyBatisMapper实体层(Entity)数据表映射对象JPA/LombokDataDTO层前后端数据传输对象数据校验注解NotBlank2.2 数据流转全流程典型请求生命周期示例以新增员工为例// 1. 前端提交 POST /employees { name: 张三, gender: 1, deptId: 101 } // 2. Controller层 PostMapping public Result addEmployee(Valid RequestBody EmployeeDTO dto) { employeeService.addEmployee(dto); return Result.success(); } // 3. Service层 Transactional public void addEmployee(EmployeeDTO dto) { Employee employee new Employee(); BeanUtils.copyProperties(dto, employee); employeeMapper.insert(employee); } // 4. Mapper层 Insert(INSERT INTO emp(name,gender,dept_id) VALUES(#{name},#{gender},#{deptId})) void insert(Employee employee);3. 分层开发实战技巧3.1 Controller层最佳实践核心原则保持精简只做三件事参数校验使用JSR-303注解调用Service返回统一响应// 错误示例在Controller写业务逻辑 PostMapping(/wrong) public Result wrongExample(RequestBody EmployeeDTO dto) { // 反模式直接操作数据库 if (employeeMapper.existsByName(dto.getName())) { return Result.error(员工已存在); } employeeMapper.insert(dto); return Result.success(); }推荐做法// 正确示例保持Controller精简 PostMapping public Result addEmployee(Valid RequestBody EmployeeDTO dto) { employeeService.addEmployee(dto); return Result.success(); }3.2 Service层开发要点事务控制是Service层的核心职责Service public class EmployeeServiceImpl implements EmployeeService { Transactional(rollbackFor Exception.class) public void updateDepartment(Long empId, Long newDeptId) { // 查询原部门 Employee emp employeeMapper.selectById(empId); Long oldDeptId emp.getDeptId(); // 更新员工部门 emp.setDeptId(newDeptId); employeeMapper.update(emp); // 更新部门人数统计 departmentMapper.decrementCount(oldDeptId); departmentMapper.incrementCount(newDeptId); } }关键点使用Transactional注解确保所有数据库操作要么全部成功要么全部回滚3.3 Mapper层优化策略动态SQL是MyBatis的核心优势!-- 员工分页查询示例 -- select idselectByPage resultTypeEmployee SELECT * FROM emp where if testname ! null and name ! AND name LIKE CONCAT(%, #{name}, %) /if if testdeptId ! null AND dept_id #{deptId} /if /where ORDER BY create_time DESC LIMIT #{start}, #{size} /select性能提示对于复杂查询建议建立合适的索引如dept_id字段避免使用SELECT *大数据量查询考虑分页优化4. 常见分层问题解决方案4.1 循环依赖问题当ServiceA依赖ServiceB同时ServiceB又依赖ServiceA时Spring启动会报错。解决方案// 错误结构 Service class ServiceA { Autowired private ServiceB serviceB; } Service class ServiceB { Autowired private ServiceA serviceA; } // 解决方案1使用Lazy延迟加载 Service class ServiceA { Lazy Autowired private ServiceB serviceB; } // 解决方案2通过构造函数注入 Service class ServiceA { private final ServiceB serviceB; public ServiceA(ServiceB serviceB) { this.serviceB serviceB; } }4.2 事务失效场景以下情况会导致Transactional失效方法不是public自调用同一个类中方法A调用方法B异常被捕获未抛出异常类型非RuntimeException且未指定rollbackFor// 事务失效示例 Service public class EmployeeService { public void batchUpdate(ListEmployee list) { list.forEach(this::updateEmployee); // 自调用导致事务失效 } Transactional public void updateEmployee(Employee emp) { employeeMapper.update(emp); } } // 正确做法 Transactional public void batchUpdate(ListEmployee list) { for (Employee emp : list) { employeeMapper.update(emp); } }5. 项目扩展与优化5.1 通用分页封装避免每个实体都重复编写分页逻辑// 通用分页查询参数 Data public class PageQuery { Min(1) private Integer page 1; Min(1) Max(100) private Integer size 10; private String sortField; private String sortOrder; } // 通用分页结果 Data public class PageResultT { private ListT list; private Long total; private Integer totalPage; } // 通用Service方法 public T PageResultT queryPage(PageQuery query, FunctionPageQuery, ListT dataSupplier, FunctionPageQuery, Long countSupplier) { ListT data dataSupplier.apply(query); Long total countSupplier.apply(query); PageResultT result new PageResult(); result.setList(data); result.setTotal(total); result.setTotalPage((total query.getSize() - 1) / query.getSize()); return result; }5.2 日志切面设计通过AOP统一处理操作日志Aspect Component Slf4j public class OperationLogAspect { Pointcut(annotation(com.example.annotation.OperateLog)) public void logPointCut() {} Around(logPointCut()) public Object around(ProceedingJoinPoint joinPoint) throws Throwable { long startTime System.currentTimeMillis(); Object result joinPoint.proceed(); long costTime System.currentTimeMillis() - startTime; saveLog(joinPoint, costTime); return result; } private void saveLog(ProceedingJoinPoint joinPoint, long costTime) { MethodSignature signature (MethodSignature) joinPoint.getSignature(); Method method signature.getMethod(); OperateLog annotation method.getAnnotation(OperateLog.class); LogEntry log new LogEntry(); log.setModule(annotation.module()); log.setType(annotation.type()); log.setCostTime(costTime); // 记录更多上下文信息... logRepository.save(log); } }6. 从Tlias看企业级开发规范通过Tlias项目我们可以总结出以下企业开发规范代码分层规范严格禁止跨层调用如Controller直接调用Mapper各层方法命名要有明确语义Service方法用业务语言异常处理规范自定义业务异常BusinessException全局异常处理器统一返回Result日志规范Controller入口/出口记录日志关键业务操作记录审计日志安全规范接口参数必须校验敏感数据脱敏处理事务规范事务注解放在Service层明确指定rollbackFor在真实项目开发中我们会发现分层架构带来的维护性优势会随着项目规模扩大而愈发明显。曾经参与过一个电商项目重构最初版本没有严格分层导致后期添加优惠券功能时需要修改20多个Controller。采用标准分层后相同的需求只需要在Service层添加一个新模块即可。