简介在软件工程实践中企业级应用开发常面临业务数据管理与流程规范化的挑战。领域驱动设计DDD与分层架构为解决复杂业务逻辑提供了清晰的设计范式其核心在于通过实体、值对象等模型抽象业务领域并利用服务层封装核心规则。Spring Boot作为Java生态中构建微服务与后台系统的首选框架以其自动配置、内嵌容器和丰富的Starter依赖极大地简化了企业级应用的初始搭建与部署流程。结合MyBatis-Plus这一持久层增强工具开发者能在保留SQL灵活性的同时通过强大的条件构造器与CRUD封装显著提升数据操作效率与代码可维护性。这种技术组合尤其适用于需要精细控制数据操作与高度定制化业务逻辑的场景例如企业内部管理系统。本文将以一个完整的资产管理系统为例详细阐述如何运用Spring Boot、MyBatis-Plus及RBAC权限模型从数据库设计、事务控制到API安全系统性地实现资产全生命周期的数字化管理为开发同类后台系统提供可复用的工程实践模板。1. 项目缘起为什么我们需要一个自研的资产管理系统在任何一个技术团队或公司里资产管理都是一个看似基础实则暗藏玄机的活儿。无论是开发用的笔记本电脑、测试用的手机平板还是服务器上的虚拟机、云端的数据库实例这些IT资产的生命周期管理——从采购入库、领用登记、状态追踪到报废回收——如果全靠Excel表格和人工记忆不出半年准保乱成一锅粥。我经历过不止一次这样的场景新同事入职行政跑过来说“领一台MacBook Pro”结果库房里翻箱倒柜半小时最后发现那台机器其实在某个已经离职同事的抽屉里“吃灰”状态根本没更新又或者某台测试服务器突然宕机想查它的配置、保修信息和负责人得在三个不同的共享文档里来回切换效率低得令人抓狂。市面上当然有成套的SaaS解决方案功能强大但要么价格不菲要么定制化程度低无法贴合我们内部特有的审批流程或资产分类规则。更重要的是数据安全与自主可控的考虑让我们更倾向于将这类核心业务数据掌握在自己手中。于是用Java技术栈自研一套轻量级、可扩展的资产管理系统就成了一个自然而然的选择。Java以其成熟的生态、稳定的性能和广泛的人才基础成为构建这类后端管理系统的可靠基石。今天我就把自己从零搭建这套系统的完整过程、技术选型的思考、以及那些踩过的“坑”和收获的经验毫无保留地分享出来。无论你是想学习一个完整的Spring Boot项目实战还是正面临类似的内部系统开发需求这篇文章都能给你提供一条清晰的路径和一堆可直接“抄作业”的代码。2. 核心架构设计如何用Spring Boot搭建稳健的后台骨架一套好的系统始于一个清晰且可持续演进的架构。我们的资产管理系统核心目标是管理“物”资产和“人”使用者之间的关系以及伴随资产全生命周期的各种“事件”入库、领用、维修、报废。因此领域驱动设计DDD中的一些核心思想在这里非常适用尽管我们不必严格遵循其所有复杂规范。2.1 技术栈选型与理由在开始敲代码之前定好技术栈是关键一步。我的选型原则是主流、稳定、社区活跃、学习成本可控。后端框架Spring Boot 2.7.x。这是毋庸置疑的选择。它极大地简化了Spring应用的初始搭建和开发过程约定大于配置内嵌Tomcat开箱即用。选择2.7.x这个长期支持版本而非最新的3.x主要是为了兼容性考虑公司内部一些老库可能还没完全适配。持久层框架MyBatis-Plus。对比纯JPAHibernate和原生MyBatisMyBatis-Plus是一个完美的折中。它保留了MyBatis对SQL的灵活控制力又通过丰富的CRUD封装和条件构造器避免了大量简单SQL的编写极大提升了开发效率。它的分页插件、性能分析插件等都非常实用。数据库MySQL 8.0。关系型数据库是管理这类具有强关联性业务数据如资产与领用记录的一对多关系的成熟选择。MySQL 8.0在性能、JSON支持以及窗口函数等方面都有不错的表现足以应对中小规模企业的数据量。缓存Redis。用于存储会话信息、高频访问的资产分类数据、以及一些简单的状态锁减轻数据库压力。权限安全Spring Security JWT。管理系统必有权限控制。Spring Security提供了强大且灵活的安全框架结合JWTJSON Web Token实现无状态认证非常适合前后端分离的架构。我们将实现基于角色的访问控制RBAC。API文档Knife4j。它是Swagger的增强版界面更友好功能更丰富能自动生成和测试API文档前后端协作利器。项目构建Maven。老牌且稳定公司内部基础设施支持完善。前端可选Vue 3 Element Plus。由于我们聚焦后端源码前端仅作为演示。Vue 3的响应式系统和组合式API开发体验很好Element Plus提供了丰富的后台组件能快速搭建管理界面。这个技术栈组合保证了项目既有企业级的稳健性又具备良好的开发体验和可维护性。2.2 数据库表结构设计详解数据库设计是系统的基石。这里我展示最核心的几张表并解释其设计意图。1. 资产类别表 (asset_category)这是资产分类的字典表采用树形结构通过parent_id自关联支持多级分类例如电子设备 - 电脑 - 笔记本电脑。CREATE TABLE asset_category ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 主键, name varchar(100) NOT NULL COMMENT 类别名称, code varchar(50) NOT NULL COMMENT 类别编码唯一, parent_id bigint(20) DEFAULT 0 COMMENT 父级ID0表示根节点, sort_order int(11) DEFAULT 0 COMMENT 排序, description varchar(500) DEFAULT NULL COMMENT 描述, create_time datetime DEFAULT CURRENT_TIMESTAMP, update_time datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_code (code), KEY idx_parent_id (parent_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT资产类别表;设计心得code字段设为唯一索引用于程序内部逻辑判断比用不稳定的name或id更可靠。树形结构便于前端渲染树形选择组件。2. 资产信息表 (asset_info)这是核心表记录每一件具体资产的信息。CREATE TABLE asset_info ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 资产ID, asset_number varchar(100) NOT NULL COMMENT 资产编号唯一如IT-2023-001, name varchar(200) NOT NULL COMMENT 资产名称, category_id bigint(20) NOT NULL COMMENT 资产类别ID, brand varchar(100) DEFAULT NULL COMMENT 品牌, model varchar(100) DEFAULT NULL COMMENT 型号, specification text COMMENT 规格详情JSON存储, sn varchar(200) DEFAULT NULL COMMENT 序列号, price decimal(15,2) DEFAULT NULL COMMENT 采购价格, purchase_date date DEFAULT NULL COMMENT 采购日期, supplier varchar(200) DEFAULT NULL COMMENT 供应商, status tinyint(4) NOT NULL DEFAULT 1 COMMENT 状态1-在库2-领用中3-已领用4-维修中5-已报废, location varchar(200) DEFAULT NULL COMMENT 存放位置, current_holder_id bigint(20) DEFAULT NULL COMMENT 当前持有人ID关联用户, current_holder_name varchar(100) DEFAULT NULL COMMENT 当前持有人姓名冗余避免连表, remark text COMMENT 备注, create_time datetime DEFAULT CURRENT_TIMESTAMP, update_time datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_asset_number (asset_number), UNIQUE KEY uk_sn (sn), KEY idx_category_id (category_id), KEY idx_status (status), KEY idx_current_holder (current_holder_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT资产信息表;踩坑记录与技巧asset_number资产编号这是资产的唯一身份标识必须全局唯一。我们采用了“IT-年份-流水号”的规则由系统自动生成。切忌让用户手动输入极易重复和出错。specification规格使用JSON类型MySQL 5.7支持或text存储JSON字符串。因为不同类别的资产规格差异巨大电脑有CPU内存服务器有IP地址办公椅有颜色。这比设计一个庞大的、包含所有可能字段的宽表要灵活得多。current_holder_name持有人姓名这是一个典型的“空间换时间”的冗余设计。虽然可以通过current_holder_id关联用户表查询姓名但在资产列表、导出等高频场景下关联查询会成为性能瓶颈。冗余存储后查询效率大幅提升只需在持有人变更时同步更新此字段即可。这是高并发系统常见的优化手段。status状态使用明确的枚举值并在代码中定义常量类。状态流转是资产管理的核心逻辑必须清晰。3. 资产领用/归还记录表 (asset_operate_log)记录资产每一次状态变更的操作流水用于审计和追溯。CREATE TABLE asset_operate_log ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 记录ID, asset_id bigint(20) NOT NULL COMMENT 资产ID, asset_number varchar(100) NOT NULL COMMENT 资产编号冗余, operate_type tinyint(4) NOT NULL COMMENT 操作类型1-入库2-领用3-归还4-送修5-返库6-报废, operator_id bigint(20) NOT NULL COMMENT 操作人ID, operator_name varchar(100) NOT NULL COMMENT 操作人姓名, target_holder_id bigint(20) DEFAULT NULL COMMENT 目标持有人ID如领用给谁, target_holder_name varchar(100) DEFAULT NULL COMMENT 目标持有人姓名, operate_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 操作时间, remark text COMMENT 操作备注, PRIMARY KEY (id), KEY idx_asset_id (asset_id), KEY idx_operate_time (operate_time) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT资产操作日志表;核心价值这张表是系统的“黑匣子”。任何对资产状态的修改都必须通过服务层产生一条日志记录。这确保了数据的可追溯性。当出现“谁拿走了我的设备”这类纠纷时查这张表一目了然。4. 用户与角色表 (sys_user, sys_role, sys_user_role)标准的RBAC三张表这里不再展开SQL重点说明与资产业务的结合点资产领用审批流程的权限控制可以基于角色实现例如“员工”只能申请“部门经理”可以审批本部门的申请“IT管理员”可以管理所有资产。3. 后端核心业务逻辑实现从Service到Controller的完整链路有了清晰的数据结构接下来就是用Java代码实现业务逻辑。我们将采用经典的分层架构Controller - Service - Mapper。3.1 领域模型与DTO设计首先创建与数据库表对应的实体类Entity这里使用Lombok简化代码。import com.baomidou.mybatisplus.annotation.*; import lombok.Data; import java.math.BigDecimal; import java.time.LocalDate; import java.time.LocalDateTime; Data TableName(asset_info) public class AssetInfo { TableId(type IdType.AUTO) private Long id; private String assetNumber; private String name; private Long categoryId; private String brand; private String model; private String specification; // JSON字符串 private String sn; private BigDecimal price; private LocalDate purchaseDate; private String supplier; private Integer status; // 对应状态枚举 private String location; private Long currentHolderId; private String currentHolderName; private String remark; TableField(fill FieldFill.INSERT) private LocalDateTime createTime; TableField(fill FieldFill.INSERT_UPDATE) private LocalDateTime updateTime; }注意这里遇到了一个常见的坑——Lombok版本与IDE/编译器的兼容性问题。如果遇到“you aren‘t using a compiler supported by lombok”错误需要检查IDE中是否安装了Lombok插件以及Maven依赖的Lombok版本是否合适。我通常使用最新稳定版并在IDE设置中启用Annotation Processing。但是Entity是直接对应数据库的不适合直接暴露给前端API。我们需要定义数据传输对象DTO和视图对象VO。1. 资产创建请求DTO (AssetCreateDTO)用于接收前端创建资产的请求包含必要的校验注解。import lombok.Data; import javax.validation.constraints.NotBlank; import javax.validation.constraints.NotNull; import java.math.BigDecimal; import java.time.LocalDate; Data public class AssetCreateDTO { NotBlank(message 资产名称不能为空) private String name; NotNull(message 资产类别不能为空) private Long categoryId; private String brand; private String model; private String sn; private BigDecimal price; private LocalDate purchaseDate; private String supplier; // 规格前端传JSON字符串后端解析为Map或自定义对象 private String specification; }2. 资产详情VO (AssetVO)返回给前端的资产详情通常需要联查其他表的信息如类别名称。import lombok.Data; import java.math.BigDecimal; import java.time.LocalDate; import java.time.LocalDateTime; import java.util.Map; Data public class AssetVO { private Long id; private String assetNumber; private String name; private Long categoryId; private String categoryName; // 联查得到 private String brand; private String model; private MapString, Object specification; // JSON反序列化为Map便于前端使用 private String sn; private BigDecimal price; private LocalDate purchaseDate; private String supplier; private Integer status; private String statusDesc; // 状态描述如“在库” private String location; private Long currentHolderId; private String currentHolderName; private String remark; private LocalDateTime createTime; }这种分层设计Entity, DTO, VO虽然增加了少量转换代码但带来了巨大的好处数据库表结构变更不影响API契约API可以灵活组合数据避免了Entity中敏感字段如密码哈希意外暴露。3.2 Service层业务逻辑的核心Service层是业务逻辑的聚集地。我们以实现“资产领用”这个核心功能为例。首先定义状态枚举和操作类型枚举让代码更清晰。// AssetStatusEnum.java Getter AllArgsConstructor public enum AssetStatusEnum { IN_STOCK(1, 在库), APPLYING(2, 领用中), IN_USE(3, 已领用), UNDER_MAINTENANCE(4, 维修中), SCRAPPED(5, 已报废); private final Integer code; private final String description; public static AssetStatusEnum of(Integer code) { return Arrays.stream(values()) .filter(e - e.getCode().equals(code)) .findFirst() .orElse(null); } } // OperateTypeEnum.java (类似略)然后编写资产领用的Service方法。这里的关键是事务性和状态一致性。Service Slf4j RequiredArgsConstructor public class AssetServiceImpl implements AssetService { private final AssetInfoMapper assetInfoMapper; private final AssetOperateLogMapper operateLogMapper; private final UserService userService; // 假设有用户服务 Override Transactional(rollbackFor Exception.class) // 关键保证以下操作原子性 public void applyAsset(Long assetId, Long applicantId, String remark) { // 1. 校验资产是否存在且状态可用 AssetInfo asset assetInfoMapper.selectById(assetId); if (asset null) { throw new BusinessException(资产不存在); } if (!AssetStatusEnum.IN_STOCK.getCode().equals(asset.getStatus())) { throw new BusinessException(资产当前状态不可领用状态为 AssetStatusEnum.of(asset.getStatus()).getDescription()); } // 2. 校验申请人是否存在 UserDTO applicant userService.getUserById(applicantId); if (applicant null) { throw new BusinessException(申请人不存在); } // 3. 更新资产状态为“领用中”这是一个中间状态等待审批 AssetInfo updateEntity new AssetInfo(); updateEntity.setId(assetId); updateEntity.setStatus(AssetStatusEnum.APPLYING.getCode()); // 注意此时持有人尚未变更 assetInfoMapper.updateById(updateEntity); // 4. 记录操作日志 AssetOperateLog log new AssetOperateLog(); log.setAssetId(assetId); log.setAssetNumber(asset.getAssetNumber()); log.setOperateType(OperateTypeEnum.APPLY.getCode()); log.setOperatorId(applicantId); log.setOperatorName(applicant.getRealName()); log.setTargetHolderId(applicantId); log.setTargetHolderName(applicant.getRealName()); log.setRemark(领用申请 remark); operateLogMapper.insert(log); // 5. 此处可集成工作流引擎如Flowable发送审批通知。简化版可跳过或写入审批表 log.info(资产[{}]领用申请已提交申请人{}, asset.getAssetNumber(), applicant.getRealName()); } // 审批通过后的“确认领用”方法 Transactional(rollbackFor Exception.class) public void confirmAssetUse(Long assetId, Long approverId) { AssetInfo asset assetInfoMapper.selectById(assetId); // 校验状态是否为“领用中” if (!AssetStatusEnum.APPLYING.getCode().equals(asset.getStatus())) { throw new BusinessException(资产当前状态不是领用中无法确认); } // 更新资产状态和持有人 AssetInfo updateEntity new AssetInfo(); updateEntity.setId(assetId); updateEntity.setStatus(AssetStatusEnum.IN_USE.getCode()); updateEntity.setCurrentHolderId(asset.getCurrentHolderId()); // 这里应该是从申请记录中取简化处理 updateEntity.setCurrentHolderName(asset.getCurrentHolderName()); assetInfoMapper.updateById(updateEntity); // 记录确认领用日志 AssetOperateLog log new AssetOperateLog(); log.setAssetId(assetId); log.setAssetNumber(asset.getAssetNumber()); log.setOperateType(OperateTypeEnum.CONFIRM_USE.getCode()); log.setOperatorId(approverId); log.setOperatorName(userService.getUserById(approverId).getRealName()); log.setTargetHolderId(asset.getCurrentHolderId()); log.setTargetHolderName(asset.getCurrentHolderName()); log.setRemark(审批通过确认领用); operateLogMapper.insert(log); } }核心要点与避坑指南事务注解Transactional领用操作涉及更新资产状态和插入日志两条数据库记录必须放在一个事务里要么全部成功要么全部回滚。这是保证数据一致性的生命线。状态机思维资产的状态流转必须定义清晰。比如从“在库”不能直接到“已报废”必须经过“申请报废”、“审批”等环节。在Service的每个方法入口都要对当前状态进行校验。先查后改任何更新操作前务必先根据ID查询出最新的实体判断其当前状态是否允许进行目标操作。直接根据前端传来的ID和状态进行更新是极其危险的会引发并发状态覆盖问题。日志先行业务操作的核心逻辑是“改状态记日志”。日志记录必须完整、准确它是事后追溯的唯一依据。3.3 Controller层构建RESTful APIController层负责接收HTTP请求调用Service并返回响应。我们使用Spring MVC并统一返回格式。首先定义一个通用的结果包装类。Data NoArgsConstructor AllArgsConstructor public class RT { private Integer code; private String msg; private T data; public static T RT ok(T data) { return new R(200, success, data); } public static T RT ok() { return ok(null); } public static T RT error(Integer code, String msg) { return new R(code, msg, null); } // 更多静态工厂方法... }然后实现资产相关的Controller。RestController RequestMapping(/api/asset) RequiredArgsConstructor Slf4j public class AssetController { private final AssetService assetService; private final AssetQueryService assetQueryService; // 查询服务分离读写 /** * 分页查询资产列表 */ GetMapping(/page) public RPageResultAssetVO getAssetPage( RequestParam(required false) String keyword, RequestParam(required false) Integer status, RequestParam(required false) Long categoryId, RequestParam(defaultValue 1) Integer pageNum, RequestParam(defaultValue 10) Integer pageSize) { PageParam pageParam new PageParam(pageNum, pageSize); PageResultAssetVO pageResult assetQueryService.queryAssetPage(keyword, status, categoryId, pageParam); return R.ok(pageResult); } /** * 获取资产详情 */ GetMapping(/{id}) public RAssetVO getAssetDetail(PathVariable Long id) { AssetVO assetVO assetQueryService.getAssetDetailById(id); return R.ok(assetVO); } /** * 创建新资产 */ PostMapping public RVoid createAsset(Valid RequestBody AssetCreateDTO createDTO) { // Valid 触发参数校验 // 生成资产编号示例IT-2023-001 String assetNumber generateAssetNumber(createDTO.getCategoryId()); assetService.createAsset(createDTO, assetNumber); return R.ok(); } /** * 提交领用申请 */ PostMapping(/{assetId}/apply) PreAuthorize(hasRole(USER)) // Spring Security 权限控制 public RVoid applyForAsset(PathVariable Long assetId, RequestBody AssetApplyDTO applyDTO) { // 从SecurityContext中获取当前登录用户ID更安全 Long currentUserId getCurrentUserId(); assetService.applyAsset(assetId, currentUserId, applyDTO.getRemark()); return R.ok(); } // 私有方法生成资产编号 private String generateAssetNumber(Long categoryId) { // 1. 根据类别ID获取前缀如IT // 2. 获取当前年份 // 3. 从Redis或数据库获取该类别当年的自增序列号 // 4. 拼接成 IT-2023-001 格式 // 伪代码需结合具体业务实现 return IT- LocalDate.now().getYear() - String.format(%03d, getNextSequence(categoryId)); } }经验之谈API设计规范遵循RESTful风格资源使用复数名词/assets操作使用HTTP方法GET/POST/PUT/DELETE。路径清晰易于理解。参数校验在DTO字段上使用NotBlank、NotNull等注解并在Controller参数前加Valid可以拦截大部分无效请求避免脏数据进入Service层。权限控制使用PreAuthorize注解在方法级别进行权限校验如hasRole(ADMIN)或hasAuthority(asset:delete)。将权限判断前置逻辑更清晰。分离查询与命令我将查询逻辑AssetQueryService和写操作逻辑AssetService分开了。这符合CQRS命令查询职责分离的思想有利于后续对查询侧做缓存优化而写侧专注于业务事务。获取当前用户切忌从请求参数中传递用户ID一定要从Spring Security的SecurityContextHolder中获取当前认证用户的信息这是安全的基础。4. 进阶功能与生产环境考量一个可用的系统搭建起来了但要投入生产环境还需要考虑更多。4.1 复杂查询与MyBatis-Plus的灵活运用资产管理少不了各种筛选和统计。MyBatis-Plus的QueryWrapper和LambdaQueryWrapper非常强大。场景前端需要一个复杂的资产列表查询支持多条件动态筛选并且需要联查资产类别名称。Service Slf4j RequiredArgsConstructor public class AssetQueryServiceImpl implements AssetQueryService { private final AssetInfoMapper assetInfoMapper; Override public PageResultAssetVO queryAssetPage(String keyword, Integer status, Long categoryId, PageParam pageParam) { // 1. 构建查询条件 LambdaQueryWrapperAssetInfo wrapper Wrappers.AssetInfolambdaQuery(); if (StringUtils.hasText(keyword)) { // 模糊匹配资产编号、名称、序列号、持有人 wrapper.and(w - w.like(AssetInfo::getAssetNumber, keyword) .or().like(AssetInfo::getName, keyword) .or().like(AssetInfo::getSn, keyword) .or().like(AssetInfo::getCurrentHolderName, keyword)); } if (status ! null) { wrapper.eq(AssetInfo::getStatus, status); } if (categoryId ! null) { // 如果需要查询某个分类及其所有子分类这里需要先递归查出子分类ID列表 ListLong categoryIds getCategoryAndChildrenIds(categoryId); wrapper.in(AssetInfo::getCategoryId, categoryIds); } wrapper.orderByDesc(AssetInfo::getCreateTime); // 默认按创建时间倒序 // 2. 执行分页查询仅查AssetInfo PageAssetInfo page new Page(pageParam.getPageNum(), pageParam.getPageSize()); PageAssetInfo assetInfoPage assetInfoMapper.selectPage(page, wrapper); // 3. 数据转换与填充解决N1查询问题 ListAssetVO assetVOList assetInfoPage.getRecords().stream().map(asset - { AssetVO vo new AssetVO(); BeanUtils.copyProperties(asset, vo); // 手动填充类别名称这里会产生N1查询需要优化 // vo.setCategoryName(categoryService.getNameById(asset.getCategoryId())); return vo; }).collect(Collectors.toList()); // 优化方案批量查询类别名称构建Map然后一次性填充 SetLong categoryIds assetVOList.stream().map(AssetVO::getCategoryId).collect(Collectors.toSet()); MapLong, String categoryNameMap categoryService.getNamesByIds(categoryIds); assetVOList.forEach(vo - vo.setCategoryName(categoryNameMap.get(vo.getCategoryId()))); // 4. 构造返回结果 return new PageResult(assetVOList, assetInfoPage.getTotal(), pageParam.getPageNum(), pageParam.getPageSize()); } // 获取分类及其所有子分类ID private ListLong getCategoryAndChildrenIds(Long parentId) { // 这里可以递归查询或者一次性查出整棵树在内存中处理。 // 如果分类层级不深数据量不大递归查询是可接受的。 // 更优方案在分类表中增加path字段如 /1/2/3查询时用 like ‘/1/%‘效率更高。 // 此处为简化示例假设有一个服务方法 return categoryService.getAllChildrenIds(parentId); } }性能优化点避免N1查询在循环中逐条查询关联信息如类别名称是性能杀手。务必使用批量查询WHERE id IN (?)先获取所有ID对应的数据再在内存中通过Map进行匹配填充。分类树查询多级分类的查询是个经典问题。除了递归可以在数据库设计时增加一个path字段存储从根节点到当前节点的ID路径查询子孙节点时用LIKE ‘/父节点路径/%‘效率极高。索引优化确保keyword模糊查询涉及的字段如asset_number,name和作为查询条件的字段如status,category_id,create_time上有合适的索引。但需注意前导模糊查询LIKE ‘%keyword’无法使用索引。4.2 导入导出功能的实现Excel导入导出是管理系统的刚需。这里推荐使用阿里开源的EasyExcel它内存占用小避免OOM。导出资产列表为例定义导出数据的VO(AssetExportVO)只包含需要导出的字段。使用EasyExcel注解标记表头。Data public class AssetExportVO { ExcelProperty(资产编号) private String assetNumber; ExcelProperty(资产名称) private String name; ExcelProperty(类别) private String categoryName; ExcelProperty(状态) private String statusDesc; ExcelProperty(当前持有人) private String currentHolderName; ExcelProperty(存放位置) private String location; ExcelProperty(入库时间) DateTimeFormat(yyyy-MM-dd HH:mm:ss) private LocalDateTime createTime; }在Controller中编写导出接口。GetMapping(/export) public void exportAssetList(HttpServletResponse response, RequestParam(required false) String keyword, RequestParam(required false) Integer status) throws IOException { // 1. 设置响应头 String fileName URLEncoder.encode(资产清单- LocalDate.now(), UTF-8).replaceAll(\\, %20); response.setContentType(application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); response.setCharacterEncoding(utf-8); response.setHeader(Content-disposition, attachment;filename*utf-8 fileName .xlsx); // 2. 查询数据这里可以复用上面的查询逻辑但通常导出数据量较大可能需要分页查询写入 ListAssetExportVO exportList assetQueryService.getExportList(keyword, status); // 3. 使用EasyExcel写入流 EasyExcel.write(response.getOutputStream(), AssetExportVO.class) .sheet(资产清单) .doWrite(exportList); }避坑指南导出大量数据如上万行时切忌一次性查询所有数据到内存再写入。应使用EasyExcel的分页查询写入功能或使用WebAsyncTask异步处理防止请求超时和内存溢出OutOfMemoryError。4.3 系统安全与数据完整性加固SQL注入防护坚持使用MyBatis-Plus的Wrapper或#{}预编译方式严禁在XML中拼接‘${}‘变量。XSS防护对于前端富文本编辑器输入的内容入库前进行HTML转义如使用HtmlUtils.htmlEscape。或者在响应时设置HTTP头Content-Type: application/json并确保前端框架如Vue能正确解析避免直接输出HTML。数据权限除了功能权限RBAC还需考虑数据权限。例如部门经理只能看到和管理本部门的资产。这需要在查询层QueryWrapper动态添加dept_id ?的条件。可以从SecurityContext中获取当前用户的部门信息在Service层或通过AOP切面自动注入查询条件。操作日志与审计我们之前设计的asset_operate_log表记录了业务操作。对于系统层面的操作如用户登录、角色修改还需要一个独立的sys_log表可以通过Spring AOP或注解方便地记录。4.4 部署与监控建议配置分离使用application.yml和application-{profile}.yml管理不同环境dev, test, prod的配置。数据库密码、Redis地址等敏感信息应放在环境变量或配置中心如Nacos, Apollo中。健康检查Spring Boot Actuator提供了/actuator/health端点可以集成到K8s的存活探针中。日志收集使用Logback或Log4j2配置合理的滚动策略和日志级别。生产环境建议将日志收集到ELKElasticsearch, Logstash, Kibana或Graylog等集中式日志平台。API文档启动项目后访问http://localhost:8080/doc.html即可看到Knife4j生成的漂亮文档方便前后端联调和测试。从一张数据表的设计到一个Service方法的事务控制再到一个API的权限校验开发一个完整的资产管理系统是对Java后端开发者综合能力的一次绝佳锻炼。这个过程里最宝贵的不是最终跑通的代码而是在设计时对业务闭环的思考在编码时对数据一致性的执着在排查问题时对日志和链路的依赖。希望这篇基于实战的详细拆解能帮你少走弯路更快地构建出属于自己的、稳定可靠的后台系统。本文还有配套的精品资源点击获取
