在实际企业 IT 资产管理中电脑硬件资产的管理往往面临信息分散、盘点困难、状态更新不及时、维保过期预警缺失等问题。一个基于 Spring Boot 的电脑硬件资产管理系统能够将资产录入、领用、变更、维修、报废等全生命周期流程线上化、规范化从而显著提升管理效率和资产利用率。项目代号hx5416可以视为一个具体的项目实例或版本标识。本文将围绕如何从零开始构建这样一个系统详细阐述其核心模块设计、技术选型、关键实现以及部署上线的完整流程。本文适合具备 Java 和 Spring Boot 基础希望学习如何将框架知识应用于实际业务系统开发的开发者。通过阅读你将能够理解一个完整后台管理系统的分层架构、数据库设计、前后端交互以及生产环境部署的要点并能够参照文中的示例代码和配置搭建起一个具备基础 CRUD、状态流转和报表功能的资产管理系统原型。1. 理解电脑硬件资产管理系统的核心业务与架构在动手编码之前必须清晰定义系统的业务边界和技术架构。一个典型的电脑硬件资产管理系统其核心是围绕“资产”实体展开的一系列状态变更和关联操作。1.1 核心业务实体与状态流转系统主要管理以下几类核心实体资产Asset核心实体包含电脑主机、显示器、键盘、鼠标等硬件设备。每个资产应有唯一标识如资产编号、型号、规格、采购日期、价格、供应商、使用部门、使用人、存放位置、资产状态如在库、领用、维修、报废等属性。资产类别Category对资产进行分类如台式机、笔记本、服务器、显示器、外设等便于统计和筛选。供应商Supplier记录采购来源信息。部门Department组织结构用于资产归属。员工Employee资产使用人。操作记录OperationLog记录资产的领用、归还、维修、报废等关键操作用于审计和追溯。资产的状态流转是其生命周期管理的核心一个简化的状态机如下在库 - 领用 - 使用中 - (维修) - 使用中 - 报废在库 - 直接报废所有状态变更都应通过特定的业务接口触发并记录操作日志。1.2 系统技术架构选型基于 Spring Boot 的快速开发特性我们采用经典的分层架构后端框架Spring Boot 2.7.x (长期支持版本稳定)数据层Spring Data JPA (简化ORM) / MyBatis-Plus (根据喜好选择) 连接 MySQL 8.0。权限安全Spring Security JWT (JSON Web Token) 实现接口鉴权。API文档SpringDoc OpenAPI 3 (替代 Swagger)。工具库Lombok, MapStruct (对象转换) Hutool (工具集)。前端考虑到管理系统以表单和表格为主可以选择 Vue 3 Element Plus 或 React Ant Design。本文后端实现将提供标准的 RESTful API前端可按需对接。部署使用 Docker 容器化部署通过 Docker Compose 编排 MySQL、Redis如需缓存和后端应用。2. 项目初始化与环境准备一个结构清晰的项目是良好开发的开始。我们使用 Spring Initializr 或 IDE 直接创建项目。2.1 使用 Spring Initializr 创建项目访问 start.spring.io 或直接在 IntelliJ IDEA 中选择New Project - Spring Initializr进行配置。Project: Maven ProjectLanguage: JavaSpring Boot: 2.7.18 (选择一个稳定的 LTS 版本)Project Metadata:Group:com.yourcompanyArtifact:asset-managementName:asset-managementPackage name:com.yourcompany.assetPackaging: JarJava: 11 或 17Dependencies: 添加以下依赖Spring WebSpring Data JPA (或 MyBatis Framework)MySQL DriverLombokSpring Security (后续手动配置)点击生成并导入到你的 IDE 中。2.2 项目目录结构规划创建完成后建议按功能模块组织包结构这比按技术分层controller, service, dao更清晰尤其对于微服务或模块化项目。但对于初学者经典分层更直观。这里展示一种结合的方式src/main/java/com/yourcompany/asset/ ├── AssetManagementApplication.java ├── config/ # 配置类 (Security, Web, Swagger等) ├── common/ # 通用组件 │ ├── constant/ # 常量 │ ├── exception/ # 全局异常处理 │ ├── result/ # 统一响应体 │ └── utils/ # 工具类 ├── module/ │ ├── asset/ # 资产模块 │ │ ├── controller/ │ │ ├── entity/ # JPA实体 或 MyBatis DO │ │ ├── dto/ # 数据传输对象 (请求/响应) │ │ ├── vo/ # 视图对象 │ │ ├── mapper/ # MyBatis Mapper接口 (如果用JPA则是repository) │ │ ├── repository/ # JPA Repository接口 │ │ ├── service/ │ │ └── converter/ # 实体-DTO转换器 │ ├── category/ # 类别模块 │ ├── supplier/ # 供应商模块 │ └── log/ # 操作日志模块 └── resources/ ├── application.yml ├── application-dev.yml ├── application-prod.yml └── static/ # 静态资源 (可选)2.3 基础依赖与配置在pom.xml中我们可能需要添加一些额外依赖。以下是一个补充示例基于 JPA!-- 对象映射工具 -- dependency groupIdorg.mapstruct/groupId artifactIdmapstruct/artifactId version1.5.5.Final/version /dependency dependency groupIdorg.mapstruct/groupId artifactIdmapstruct-processor/artifactId version1.5.5.Final/version scopeprovided/scope /dependency !-- JWT 支持 -- dependency groupIdio.jsonwebtoken/groupId artifactIdjjwt-api/artifactId version0.11.5/version /dependency dependency groupIdio.jsonwebtoken/groupId artifactIdjjwt-impl/artifactId version0.11.5/version scoperuntime/scope /dependency dependency groupIdio.jsonwebtoken/groupId artifactIdjjwt-jackson/artifactId version0.11.5/version scoperuntime/scope /dependency !-- 参数校验 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-validation/artifactId /dependency接下来配置application.yml和application-dev.yml。主配置文件application.yml用于设置激活的环境和通用配置spring: profiles: active: dev # 默认激活开发环境 application: name: asset-management server: port: 8080 servlet: context-path: /api # 统一API前缀 # 日志配置 logging: level: com.yourcompany.asset: DEBUG org.springframework.security: DEBUG开发环境配置文件application-dev.ymlspring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/asset_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: yourpassword jpa: hibernate: ddl-auto: update # 开发环境可用update生产环境必须用validate或none show-sql: true properties: hibernate: format_sql: true dialect: org.hibernate.dialect.MySQL8Dialect # JWT配置 jwt: secret: your-256-bit-secret-key-change-in-production # 生产环境必须更换为强密钥 expiration: 86400000 # token有效期单位毫秒 (24小时)注意spring.jpa.hibernate.ddl-auto: update在开发初期可以自动创建和更新表结构但生产环境绝对禁止使用。生产环境应该使用validate或none并通过 Flyway 或 Liquibase 进行数据库版本管理。3. 核心模块设计与实现我们将以“资产Asset”模块为例详细展示从实体定义到接口暴露的完整流程。3.1 数据库实体设计首先定义资产实体。使用 JPA 注解进行对象-关系映射。package com.yourcompany.asset.module.asset.entity; import lombok.Data; import javax.persistence.*; import java.math.BigDecimal; import java.time.LocalDate; import java.time.LocalDateTime; Entity Table(name asset) Data public class Asset { Id GeneratedValue(strategy GenerationType.IDENTITY) private Long id; Column(unique true, nullable false, length 50) private String assetNumber; // 资产编号唯一 Column(nullable false, length 100) private String name; // 资产名称 ManyToOne JoinColumn(name category_id, nullable false) private Category category; // 关联类别 Column(length 200) private String specification; // 规格型号 private String brand; // 品牌 Column(precision 12, scale 2) private BigDecimal purchasePrice; // 采购价格 private LocalDate purchaseDate; // 采购日期 ManyToOne JoinColumn(name supplier_id) private Supplier supplier; // 关联供应商 ManyToOne JoinColumn(name department_id) private Department department; // 所属部门 ManyToOne JoinColumn(name employee_id) private Employee employee; // 使用人 Column(length 100) private String location; // 存放位置 Enumerated(EnumType.STRING) Column(nullable false, length 20) private AssetStatus status AssetStatus.IN_STOCK; // 资产状态默认在库 Column(length 500) private String remark; // 备注 Column(updatable false) private LocalDateTime createTime; private LocalDateTime updateTime; PrePersist protected void onCreate() { createTime LocalDateTime.now(); updateTime LocalDateTime.now(); } PreUpdate protected void onUpdate() { updateTime LocalDateTime.now(); } // 资产状态枚举 public enum AssetStatus { IN_STOCK, // 在库 IN_USE, // 使用中 UNDER_MAINTENANCE, // 维修中 SCRAPPED // 已报废 } }对应的类别Category、供应商Supplier等实体结构类似均为简单的主键、名称、编码等字段此处省略。3.2 数据访问层使用 Spring Data JPA 的Repository接口可以快速实现基础 CRUD 和复杂查询。package com.yourcompany.asset.module.asset.repository; import com.yourcompany.asset.module.asset.entity.Asset; import org.springframework.data.jpa.repository.JpaRepository; import org.springframework.data.jpa.repository.JpaSpecificationExecutor; import org.springframework.stereotype.Repository; import java.util.Optional; Repository public interface AssetRepository extends JpaRepositoryAsset, Long, JpaSpecificationExecutorAsset { OptionalAsset findByAssetNumber(String assetNumber); boolean existsByAssetNumber(String assetNumber); // 可以根据部门、状态等条件定义更多查询方法 // ListAsset findByDepartmentIdAndStatus(Long departmentId, Asset.AssetStatus status); }JpaSpecificationExecutor接口允许我们使用Specification进行动态条件查询这对于后端管理系统的多条件分页查询非常有用。3.3 业务逻辑层Service 层负责核心业务逻辑如资产的状态流转校验。package com.yourcompany.asset.module.asset.service; import com.yourcompany.asset.module.asset.entity.Asset; import com.yourcompany.asset.module.asset.repository.AssetRepository; import lombok.RequiredArgsConstructor; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; Service RequiredArgsConstructor public class AssetService { private final AssetRepository assetRepository; public Asset createAsset(Asset asset) { // 校验资产编号唯一性 if (assetRepository.existsByAssetNumber(asset.getAssetNumber())) { throw new RuntimeException(资产编号已存在); } // 其他业务校验... return assetRepository.save(asset); } Transactional public Asset allocateAsset(Long assetId, Long employeeId, Long departmentId) { Asset asset assetRepository.findById(assetId) .orElseThrow(() - new RuntimeException(资产不存在)); // 状态校验只有“在库”的资产才能被领用 if (asset.getStatus() ! Asset.AssetStatus.IN_STOCK) { throw new RuntimeException(当前资产状态不允许领用); } // 更新使用人、部门、状态 // asset.setEmployee(...); // asset.setDepartment(...); asset.setStatus(Asset.AssetStatus.IN_USE); // 记录操作日志... return assetRepository.save(asset); } Transactional public Asset scrapAsset(Long assetId, String reason) { Asset asset assetRepository.findById(assetId) .orElseThrow(() - new RuntimeException(资产不存在)); // 状态校验通常只有“在库”或“使用中”的资产可以申请报废 if (asset.getStatus() Asset.AssetStatus.SCRAPPED) { throw new RuntimeException(资产已报废); } asset.setStatus(Asset.AssetStatus.SCRAPPED); // asset.setRemark(reason); // 记录操作日志... return assetRepository.save(asset); } // 其他方法update, query, returnAsset, maintainAsset 等 }3.4 控制器层与 DTOController 层接收 HTTP 请求调用 Service并返回统一格式的响应。使用 DTOData Transfer Object来隔离实体和接口避免暴露不必要的字段或循环引用。首先定义统一的响应体Resultpackage com.yourcompany.asset.common.result; import lombok.Data; Data public class ResultT { private Integer code; private String message; private T data; public static T ResultT success(T data) { ResultT result new Result(); result.setCode(200); result.setMessage(success); result.setData(data); return result; } // 可以定义其他静态方法如 fail, error 等 }定义资产相关的请求和响应 DTOpackage com.yourcompany.asset.module.asset.dto; 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 assetNumber; NotBlank(message 资产名称不能为空) private String name; NotNull(message 类别ID不能为空) private Long categoryId; private String specification; private String brand; private BigDecimal purchasePrice; private LocalDate purchaseDate; private Long supplierId; private Long departmentId; private Long employeeId; private String location; private String remark; }使用 MapStruct 定义转换器package com.yourcompany.asset.module.asset.converter; import com.yourcompany.asset.module.asset.dto.AssetCreateDTO; import com.yourcompany.asset.module.asset.entity.Asset; import org.mapstruct.Mapper; import org.mapstruct.Mapping; import org.mapstruct.factory.Mappers; Mapper(componentModel spring) public interface AssetConverter { AssetConverter INSTANCE Mappers.getMapper(AssetConverter.class); // 忽略id, createTime等字段的映射 Mapping(target id, ignore true) Mapping(target createTime, ignore true) Mapping(target updateTime, ignore true) Mapping(target category, ignore true) // 需要单独处理关联对象 Mapping(target supplier, ignore true) Mapping(target department, ignore true) Mapping(target employee, ignore true) Asset toEntity(AssetCreateDTO dto); }最后实现 Controllerpackage com.yourcompany.asset.module.asset.controller; import com.yourcompany.asset.common.result.Result; import com.yourcompany.asset.module.asset.dto.AssetCreateDTO; import com.yourcompany.asset.module.asset.entity.Asset; import com.yourcompany.asset.module.asset.service.AssetService; import lombok.RequiredArgsConstructor; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; RestController RequestMapping(/assets) RequiredArgsConstructor public class AssetController { private final AssetService assetService; private final AssetConverter assetConverter; PostMapping public ResultAsset createAsset(Validated RequestBody AssetCreateDTO dto) { // DTO 转 Entity并处理关联对象需要先查询出来 Asset asset assetConverter.toEntity(dto); // 这里需要根据dto中的ID去查询并设置category, supplier等关联对象 // asset.setCategory(categoryRepository.findById(dto.getCategoryId()).orElseThrow(...)); Asset savedAsset assetService.createAsset(asset); return Result.success(savedAsset); } PutMapping(/{id}/allocate) public ResultAsset allocateAsset(PathVariable Long id, RequestParam Long employeeId, RequestParam Long departmentId) { Asset asset assetService.allocateAsset(id, employeeId, departmentId); return Result.success(asset); } GetMapping(/{id}) public ResultAsset getAsset(PathVariable Long id) { // 查询逻辑... return Result.success(...); } // 其他接口分页查询、更新、报废等 }4. 高级功能与生产环境考量基础 CRUD 完成后一个可用的管理系统还需要考虑权限、日志、数据导出、部署等生产级功能。4.1 集成 Spring Security 与 JWT管理系统必须要有权限控制。我们实现一个简单的基于 Token 的认证授权。添加 Security 配置类package com.yourcompany.asset.config; import lombok.RequiredArgsConstructor; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.security.config.annotation.web.builders.HttpSecurity; import org.springframework.security.config.http.SessionCreationPolicy; import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder; import org.springframework.security.crypto.password.PasswordEncoder; import org.springframework.security.web.SecurityFilterChain; import org.springframework.security.web.authentication.UsernamePasswordAuthenticationFilter; Configuration RequiredArgsConstructor public class SecurityConfig { private final JwtAuthenticationFilter jwtAuthenticationFilter; Bean public SecurityFilterChain filterChain(HttpSecurity http) throws Exception { http .csrf().disable() // 前后端分离项目通常禁用CSRF .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS) // 无状态 .and() .authorizeRequests() .antMatchers(/auth/login, /swagger-ui/**, /v3/api-docs/**).permitAll() // 放行登录和API文档 .anyRequest().authenticated() // 其他所有请求需要认证 .and() .addFilterBefore(jwtAuthenticationFilter, UsernamePasswordAuthenticationFilter.class); // 添加JWT过滤器 return http.build(); } Bean public PasswordEncoder passwordEncoder() { return new BCryptPasswordEncoder(); } }实现 JWT 工具类与过滤器代码较长简述核心JwtUtil负责生成、解析、验证 Token。JwtAuthenticationFilter继承OncePerRequestFilter从请求头Authorization中提取 Token验证后设置用户认证信息到SecurityContextHolder。AuthController提供/auth/login接口验证用户名密码后调用JwtUtil生成 Token 返回。4.2 操作日志记录关键业务操作增、删、改、状态变更需要记录日志。可以使用 Spring AOP 实现。package com.yourcompany.asset.common.aspect; import lombok.extern.slf4j.Slf4j; import org.aspectj.lang.JoinPoint; import org.aspectj.lang.annotation.AfterReturning; import org.aspectj.lang.annotation.Aspect; import org.aspectj.lang.annotation.Pointcut; import org.springframework.stereotype.Component; import org.springframework.web.context.request.RequestContextHolder; import org.springframework.web.context.request.ServletRequestAttributes; import javax.servlet.http.HttpServletRequest; import java.util.Arrays; Aspect Component Slf4j public class OperationLogAspect { // 定义切点标注了 LogOperation 注解的方法 Pointcut(annotation(com.yourcompany.asset.common.annotation.LogOperation)) public void logPointCut() {} AfterReturning(pointcut logPointCut(), returning result) public void doAfterReturning(JoinPoint joinPoint, Object result) { // 获取当前请求 ServletRequestAttributes attributes (ServletRequestAttributes) RequestContextHolder.getRequestAttributes(); if (attributes null) { return; } HttpServletRequest request attributes.getRequest(); // 从SecurityContext获取当前用户 // String username SecurityUtils.getCurrentUsername(); // 获取方法名、参数、IP、结果等信息 String methodName joinPoint.getSignature().getName(); String params Arrays.toString(joinPoint.getArgs()); // 构造日志实体并异步保存到数据库避免影响主业务 // operationLogService.saveAsync(logEntity); log.info(操作日志: 用户[{}], IP[{}], 方法[{}], 参数[{}], 结果[{}], username, request.getRemoteAddr(), methodName, params, result); } }然后在需要记录日志的 Service 方法上添加自定义的LogOperation注解即可。4.3 数据导出与报表资产盘点、统计报表是常见需求。可以使用 Apache POI 导出 Excel或集成 EasyExcel阿里开源获得更好的性能。添加依赖dependency groupIdcom.alibaba/groupId artifactIdeasyexcel/artifactId version3.3.2/version /dependency定义导出数据的 VO 和监听器Data public class AssetExportVO { ExcelProperty(资产编号) private String assetNumber; ExcelProperty(资产名称) private String name; ExcelProperty(类别) private String categoryName; ExcelProperty(使用部门) private String departmentName; ExcelProperty(使用人) private String employeeName; ExcelProperty(状态) private String status; // ... 其他字段 }在 Controller 中提供导出接口GetMapping(/export) public void exportAssets(HttpServletResponse response, RequestParam(required false) String status, RequestParam(required false) Long departmentId) { // 1. 设置响应头 response.setContentType(application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); response.setCharacterEncoding(utf-8); String fileName URLEncoder.encode(资产清单, UTF-8).replaceAll(\\, %20); response.setHeader(Content-disposition, attachment;filename*utf-8 fileName .xlsx); // 2. 查询数据并转换为 AssetExportVO 列表 ListAssetExportVO list assetService.getExportList(status, departmentId); // 3. 使用 EasyExcel 写入响应流 EasyExcel.write(response.getOutputStream(), AssetExportVO.class) .sheet(资产清单) .doWrite(list); }4.4 Docker 容器化部署生产环境推荐使用 Docker 部署保证环境一致性。编写 Dockerfile# 使用官方 OpenJDK 运行时作为父镜像 FROM openjdk:11-jre-slim # 设置工作目录 WORKDIR /app # 将构建好的 jar 包复制到容器中 COPY target/asset-management-0.0.1-SNAPSHOT.jar app.jar # 暴露端口 EXPOSE 8080 # 运行 jar 包 ENTRYPOINT [java, -jar, app.jar]编写 docker-compose.yml集成 MySQLversion: 3.8 services: mysql: image: mysql:8.0 container_name: asset-mysql environment: MYSQL_ROOT_PASSWORD: your_strong_password MYSQL_DATABASE: asset_db ports: - 3306:3306 volumes: - mysql_data:/var/lib/mysql command: --default-authentication-pluginmysql_native_password restart: unless-stopped app: build: . container_name: asset-app depends_on: - mysql environment: SPRING_PROFILES_ACTIVE: prod SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/asset_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse SPRING_DATASOURCE_USERNAME: root SPRING_DATASOURCE_PASSWORD: your_strong_password ports: - 8080:8080 restart: unless-stopped volumes: mysql_data:部署步骤在项目根目录执行mvn clean package -DskipTests打包。确保docker-compose.yml和Dockerfile在正确位置。执行docker-compose up -d启动服务。通过docker-compose logs -f app查看应用日志。5. 常见问题排查与最佳实践在开发和部署过程中会遇到各种问题。以下是一些典型场景的排查思路。5.1 数据库连接与 JPA 相关问题问题现象可能原因检查方式处理建议启动时报Communications link failure1. MySQL 服务未启动。2. 连接 URL、用户名、密码错误。3. 网络不通或防火墙阻挡。1.docker ps或systemctl status mysql检查服务。2. 用命令行工具如mysql -u root -p测试连接。3.telnet host port测试端口。1. 启动服务。2. 核对application.yml配置。3. 检查防火墙规则确保端口开放。启动时报Table ‘xxx’ doesn‘t exist1.ddl-auto设置为none或validate但表未创建。2. 实体类与数据库表名/字段名映射错误。1. 检查spring.jpa.hibernate.ddl-auto配置。2. 检查实体类Table,Column注解。3. 查看生成的 SQL 日志。1. 开发环境可临时改为update或使用 Flyway 脚本。2. 修正注解或使用Column(name “db_column_name”)显式指定。查询时出现LazyInitializationException在事务外部访问了懒加载ManyToOne,OneToMany的属性。检查抛出异常的代码行是否在Transactional方法外访问了关联对象。1. 将涉及懒加载属性的操作放在事务方法内。2. 查询时使用EntityGraph或JOIN FETCH主动抓取关联数据。3. 在 DTO 中避免直接暴露实体通过转换器提前加载所需数据。5.2 Spring Security 与 JWT 相关问题问题现象可能原因检查方式处理建议登录成功但访问接口返回 4031. Token 未正确放入请求头。2. Token 已过期。3. 接口路径未被正确放行。1. 检查前端请求头Authorization: Bearer token。2. 用工具如 jwt.io解码 Token 检查过期时间。3. 检查SecurityConfig中antMatchers的配置。1. 确保请求头格式正确。2. 刷新 Token。3. 调整 Security 配置确保路径匹配正确。自定义的UserDetailsService未生效1. 未添加Service注解。2. 存在多个UserDetailsServiceBean。3. 未正确配置AuthenticationManager。1. 检查类是否有Service。2. 查看启动日志是否有 Bean 冲突警告。3. 在SecurityConfig中尝试Bean暴露AuthenticationManager。1. 添加注解。2. 使用Primary注解指定主 Bean。3. 在配置类中定义AuthenticationManagerBean。5.3 生产环境部署注意事项配置文件分离使用application-prod.yml并通过环境变量SPRING_PROFILES_ACTIVEprod激活。生产配置必须移除show-sql并将ddl-auto设为validate或none。数据库密码切勿硬编码在配置文件中。使用 Docker Secret、Kubernetes ConfigMap 或 Spring Cloud Config 从外部注入。在docker-compose.yml中也可使用环境变量文件.env。JWT Secret生产环境必须使用足够复杂且保密的密钥建议通过环境变量注入。日志管理配置日志滚动策略如 Logback并输出到文件。集成 ELKElasticsearch, Logstash, Kibana或 Sentry 进行日志收集和监控。健康检查Spring Boot Actuator 提供/actuator/health端点可用于容器健康检查。在docker-compose.yml中配置healthcheck。性能监控考虑集成 Micrometer 和 Prometheus暴露应用指标。5.4 代码层面的最佳实践DTO 与 Entity 分离如示例所示严格区分请求/响应对象与数据库实体避免 API 变动直接冲击数据库结构也防止意外暴露敏感字段。统一异常处理使用ControllerAdvice和ExceptionHandler创建全局异常处理器将各类异常转换为统一的错误响应格式。接口幂等性对于创建、更新、状态变更等接口要考虑幂等设计防止网络重试导致重复操作。可以使用唯一业务编号如资产编号或 Token 机制。分页查询所有列表查询接口必须支持分页避免一次性拉取大量数据。使用 Spring Data 的Pageable和Page对象。数据权限根据用户角色或所属部门过滤其能查看和操作的资产数据。这需要在查询层Repository 或 Service动态添加过滤条件。通过以上步骤一个基于 Spring Boot 的电脑硬件资产管理系统核心骨架就已搭建完成。后续可以根据实际业务需求继续扩展如折旧计算、维保合同管理、邮件预警、移动端适配等功能。关键在于理解业务实体、状态流转和数据关系并运用 Spring Boot 生态提供的各种组件以模块化、可维护的方式构建系统。