在正式输出前我先梳理这篇文章的结构方案确保它不套用模板、贴合这个具体标题的价值点标题核心是什么一个可直接复现的“公司资产网站系统”全栈项目涉及SpringBoot、Vue3、MyBatis、MySQL、前后端分离。读者最需要知道什么这个系统解决什么业务、表结构怎么设计、后端核心接口怎么落、前端从Vue3项目初始化到联调有哪些坑、源码拿到后部署时有哪些容易翻车的地方。切入角度从一个实际场景引入——公司里资产登记还在用Excel借出去找不回来盘点靠肉眼这样这个项目的意义就自然立住了。按照直接开写、内容充实的原则组织章节名直接点出各阶段要解决的问题避免通用模板。下面输出正文。1. 管公司资产为什么需要一个网站系统先从业务场景说起大多数中小公司在资产管理上都没有正经系统。行政部门发一台笔记本电脑靠的是Excel登记员工拿到电脑后换部门、离职、硬盘坏了要维修系统里毫无记录行政只能靠问、靠翻聊天记录。到了年中盘点财务要核对资产原值行政要核对实物状态两边数据对不上最后只能“拍脑袋平账”。这个项目要解决的就是这一整条链路的数字化问题。标题里的“公司资产网站系统”本质上是一个资产全生命周期管理系统。所谓全生命周期指的是从资产入库开始到领用、借用、归还、维修、调拨、盘点、报废每个环节都有记录、有状态、有操作人、有时间戳。有了这些记录行政不再靠记忆管理资产财务做折旧和原值核销也有据可查老板看报表时能知道公司到底有多少家底、有多少资产闲置、多少资产在个人手里。从技术角度看这个系统又是一个特别典型的前后端分离全栈项目后端用SpringBoot提供REST接口前端用Vue3做单页应用持久层用MyBatis操作MySQL项目自带一套完整的源码结构适合做毕设、做内部管理系统的起点工程也适合正在学Java全栈的开发者拿来拆解。你拿到的不是“一个登录一个HelloWorld”而是带有真实业务含义的资产登记、二维码标签、领借还、盘点、权限管理这几个核心模块。我的建议是拿到源码先别急着启动运行先把这个项目的业务模型和表结构吃透。技术栈固然重要但这类管理系统最值钱的恰恰是数据建模和状态流转设计——后面的章节我会逐个拆开讲。2. 技术选型不是凑热闹SpringBootVue3MyBatis到底各自解决什么问题很多人看到“前后端分离Vue3SpringBoot”第一反应是“用的都是热门技术”但选型背后的逻辑很少有人说清楚。我按数据流的方向拆一下浏览器端是Vue3负责页面渲染和用户交互服务器端是SpringBoot负责业务逻辑和接口暴露数据库层MySQL存持久化数据而MyBatis夹在SpringBoot和MySQL之间专门负责SQL映射。2.1 为什么是SpringBoot而不是SSH或者Spring MVC先说后端。以前写Java Web用SSHStruts2SpringHibernate或者传统Spring MVC光是配置文件就能写一整天数据源配置、事务配置、扫描配置、视图解析器配置新手光是把环境跑起来就要折腾两三天。SpringBoot把这些繁琐的配置全部自动化和约定化application.yml里写上数据库连接信息引入依赖后它自己就知道怎么装配。对资产系统这种典型的CRUD事务场景SpringBoot的自动配置、Starter机制、内嵌Tomcat这三个特性非常合适——本地直接java -jar就能跑部署不需要额外装Tomcat。2.2 为什么选MyBatis而不是JPA这可能是这个项目里最值得琢磨的选型。资产管理系统里SQL并不复杂但存在大量“带条件的动态统计”按部门统计资产数量、按状态筛资产清单、按时间范围查借还记录、盘点单和盘点明细的多表关联。MyBatis对这类场景的优势非常明显SQL由你亲手控制动态SQL用if、where、foreach标签拼接该怎么查就怎么查性能可控排错直观。JPA/Hibernate虽然也能做但它更适合领域对象关系很重的业务而且一旦涉及多表联查和复杂统计要么你写JPQL要么用原生SQL反而不如MyBatis直接写XML来得顺手。再看面试时容易被问到的点——MyBatis的一级缓存、二级缓存、TypeHandler这些在这个项目里的Settings和TypeHandler配置中都有实际落脚点学完框架再看项目会非常有感觉。2.3 Vue3在这个项目里具体负责什么Vue3相比Vue2的核心变化是Composition API配合script setup语法组件逻辑组织比Options API清晰得多。资产系统有大量表单页面——新增资产、编辑资产、借用登记、归还登记——这些页面很多字段是重复的用Composition API把“表单校验逻辑”抽成公共的useAssetForm函数或者把“分页请求逻辑”抽成usePagination组合函数多个页面复用同一套逻辑代码量直接砍半。前端这块还牵扯到Vite、Element Plus组件库、Pinia状态管理、Axios请求封装、Vue Router动态路由。这些组合起来构建出的资产管理系统前端本质上是一个“后台管理系统”的典型形态。标题里既然带Vue3那就不是简单引入一下而已——你要能讲清楚页面是什么结构、路由守卫怎么控制权限、token怎么存、接口怎么封装。3. 数据库是地基资产系统MySQL表结构设计的核心关键点做管理系统技术写得再花哨表结构一塌糊涂照样白搭。我这里把项目中最重要的几张表拆解一下你对照源码中的SQL脚本看会非常清楚。3.1 核心表拆解与字段设计这个系统至少包含用户表、角色表、权限表、资产类别表、资产档案表、资产领用记录表、资产借还记录表、盘点任务表、盘点明细表、操作日志表这十张表。我挑资产档案表和借还记录表展开说。资产档案表asset_info的字段设计有几个关键点字段名类型说明idbigint主键自增asset_codevarchar(64)资产编号唯一索引建议格式ZC部门简码年月序列asset_namevarchar(128)资产名称如“ThinkPad X1 Carbon”asset_type_idbigint关联资产类别表specvarchar(255)规格型号snvarchar(128)出厂序列号很多公司忽略这个字段导致保修期到了不知道pricedecimal(10,2)资产原值财务折旧要用purchase_datedate购入日期statustinyint核心状态字段1在库、2已领用、3借出、4维修中、5已报废current_user_idbigint当前使用人这是极其重要的反范式设计locationvarchar(255)存放位置qr_codevarchar(255)二维码内容标签打印用create_timedatetime创建时间这里有两个容易被忽略的设计诀窍。第一个是status和current_user_id冗余在资产表上。表面上看当前使用人可以通过“领用记录”表的最新一条记录推导出来但资产列表页每页要显示几十条数据如果每次都去联查“最新记录”SQL写起来麻烦索引设计也复杂。直接在资产表上冗余这两个字段每次领用、借用、归还时在业务层同步更新查询就不需要子查询。空间换时间对管理系统是常见且务实的选择。第二个是资产编号asset_code必须加唯一索引。真实公司里资产编号就是资产的“身份证”Excel时代最常出现的问题是编号重复、漏编数据库层面挡住这个口子可以避免非常多的后续脏数据。盘点这个业务为什么要单拆两张表盘点任务表和盘点明细表因为盘点是一个“以账对物”的过程。盘点任务表记录某年某次的盘点范围、盘点人、盘点状态盘点明细表记录每个资产在本次盘点中的“账面状态”和“实际盘点状态”如果两者不一致就记为盘盈或盘亏。这里需要两个状态字段不能只存一个结果——因为财务后续要区分盘盈资产入账和盘亏资产报损处理逻辑完全不同。3.2 为什么字段类型要这样设计时间、金额、状态的实践选择时间字段统一用datetime而不是varchar这是硬性要求如果用varchar存时间排序会按字典序跨年时会排错而且MySQL的DATE_FORMAT、TIMESTAMPDIFF这些函数直接失效。金额用decimal(10,2)而不用float/doublefloat有精度损失对资产原值、折旧金额这种需要精确计算的数据来说是不可接受的。状态字段用tinyint而不是varchar存“在库”“借出”这样的中文文案——文案可以改变数字状态码稳定展示层去映射成中文就可以了。索引设计上asset_info表的status、department_id、purchase_date这些查询条件字段建议建普通索引因为资产列表页最常做的筛选就是“按状态看全部”“按部门看资产”。借还记录表则一定要建asset_id, create_time联合索引因为查询“某资产的历史借还流水”是最核心的查询路径。3.3 MySQL配置与导入时最常见的坑源码里一般会带一个asset_system.sql脚本。导入MySQL时最容易踩的坑有三个字符集、时区、sql_mode。脚本里最好显式写DEFAULT CHARSETutf8mb4否则插入emoji等情况会出现数据丢失数据库连接串务必带serverTimezoneAsia/Shanghai不然Java连接MySQL 8.x时会报时区错误这已经是老生常谈但每届新手都要踩一遍的坑MySQL 5.7及以上默认启用严格模式如果脚本中有不规范的默认值比如date字段直接默认空字符串导入时就会报错这时要么改脚本要么在my.cnf中调整sql_mode。提示这里先说一下方案的选择逻辑。数据库面向的核心是“状态查询和流转记录”所以反范式设计、状态机、流水表是主题而不用刻意追求教科书式的范式化那样对管理系统的查询性能反而是负担。4. 后端核心逻辑拆解SpringBoot工程结构与资产借还闭环实现后端工程建议以Maven构建包结构采用经典的controller/service/mapper/entity分层。controller层只做参数接收和结果封装service层做业务逻辑和事务控制mapper层只做数据库操作。这个分层看起来简单但很多刚从培训班出来的人写代码喜欢在controller里堆逻辑导致后面加一个“归还资产时同时生成日志记录”的需求都要改好几个方法。分层清晰以后加需求的时候定位就非常快。4.1 核心依赖配置与启动类pom.xml里必不可少的依赖包括spring-boot-starter-web、mybatis-spring-boot-starter、mysql-connector-j、lombok。这是后端跑起来的最基本组合。特别提醒mybatis-spring-boot-starter的版本要和SpringBoot版本匹配SpringBoot 2.x对应mybatis-starter 2.xSpringBoot 3.x对应mybatis-starter 3.x如果版本不对最常见的问题就是启动时找不到SqlSessionFactory。application.yml里的几个关键点spring: datasource: url: jdbc:mysql://localhost:3306/asset_system?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue username: root password: yourpassword driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.asset.entity configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImplmap-underscore-to-camel-casetrue这一段非常关键。如果数据库字段是create_time而Java实体属性是createTime没有这个配置的话查询结果映射出来就是null。log-impl配置成StdOutImpl可以把MyBatis执行的SQL打印到控制台调试时直接看SQL是很爽的排查N1问题、参数传递问题都靠这个。4.2 资产借用与归还状态流转和事务控制的核心资产借用是资产系统里业务逻辑最典型的一个模块。我先说流程员工提交借用申请填写借用资产、预计归还时间管理员审批后资产状态由“在库”改为“借出”同时在借还记录表中插入一条记录归还时管理员确认资产状况状态改为“在库”更新借还记录的归还时间。这个流程放到代码里就是两个数据库操作协同更新资产状态插入借还记录。这两个操作必须放在同一个事务里否则可能出现资产状态改了但流水没记上或者流水记了但资产状态没改。实现方式就是Service层方法上加Transactional注解。借用的Service方法大概长这样Transactional(rollbackFor Exception.class) public void borrowAsset(BorrowDTO dto) { AssetInfo asset assetMapper.selectByIdForUpdate(dto.getAssetId()); if (asset null || asset.getStatus() ! 1) { throw new BizException(该资产当前不可借用); } asset.setStatus(3); asset.setCurrentUserId(dto.getUserId()); assetMapper.updateById(asset); BorrowRecord record new BorrowRecord(); record.setAssetId(dto.getAssetId()); record.setUserId(dto.getUserId()); record.setBorrowTime(new Date()); record.setExpectReturnTime(dto.getExpectReturnTime()); record.setStatus(1); borrowRecordMapper.insert(record); }这里有一个关键操作selectByIdForUpdate。这个“ForUpdate”是行级锁它的作用是在并发情况下两个人同时操作同一个资产时后者必须等前者事务提交后才能读到数据。没有这把锁的话两台电脑同时点击“借用成功”资产状态可能被覆盖记录也可能乱掉。这属于典型的并发控制问题如果面试官问起“数据一致性怎么保证”这是一个很实在的回答素材。归还逻辑同理先校验借还记录的合法性把该资产的状态还原为在库同时更新记录状态和实际归还时间。归还时建议顺带记录资产外观状况字段比如“正常/有磨损/部件缺失”这个信息对后续维修和报废判断非常有用。4.3 盘点流程的状态机设计盘点流程也是一个状态机创建盘点任务状态为待盘点→ 盘点人逐项确认资产状态变为已盘→ 完成盘点状态为已完成 → 生成盘盈盘亏明细。这里实现上的一个关键点是盘点单明细表中的“账面状态”是在创建盘点任务时从资产表快照复制过去的不是动态联查的。为什么因为盘点本身就是核对账实是否一致如果所有数据都动态查当前库资产中间变了就说不清了快照才能还原“盘点当时”的账面情况后面做差异分析才有依据。4.4 MyBatis的XML映射与动态SQL写法Mapper的XML文件是这个项目的核心资产之一。资产列表页往往需要多条件筛选按名称模糊查询、按类别、按状态、按购入日期范围。用动态SQL写select idselectByCondition resultTypecom.example.asset.entity.AssetInfo select * from asset_info where if testname ! null and name ! and asset_name like concat(%, #{name}, %) /if if testassetTypeId ! null and asset_type_id #{assetTypeId} /if if teststatus ! null and status #{status} /if if testpurchaseDateBegin ! null and purchase_date gt; #{purchaseDateBegin} /if if testpurchaseDateEnd ! null and purchase_date lt; #{purchaseDateEnd} /if /where order by create_time desc /selectwhere标签会自动处理“第一个条件前的and”问题你写的条件再多也不用担心拼接出where and status 1这种SQL。注意和在XML里必须转义成gt;和lt;这是XML映射文件中特别容易报错的地方——很多新手在这里卡半小时编译器提示“元素内容必须由格式正确的字符数据或标记组成”其实就是小于号没转义。关于MyBatis的一级二级缓存在这个管理系统场景里我的建议是查低频数据的场景可以开二级缓存但资产表这种频繁更新状态的表不建议开。因为任何一次状态更新都会导致缓存失效频繁失效反而降低性能而且资产状态读到的若是脏数据可能让管理员误判。默认关闭就好不要把缓存当万能药。5. Vue3前端落地从项目初始化到前后端联调的完整路径标题里既然带Vue3前端这部分就要真正讲透。项目建议用Vite作为构建工具初始化创建命令npm create vuelatest这个脚手架会询问你是否需要Vue Router、Pinia、ESLint等资产管理系统按需选择需要Router、需要Pinia测试和ESLint看个人习惯。为什么用Vite而不用WebpackVite基于ESModule冷启动速度极快几秒钟就能起来开发体验比Webpack好得多生产构建是通过Rollup打包产物质量和体积也可控。5.1 前端工程目录结构与核心模块职责建议的目录结构是这样src/ api/ # 接口请求封装按模块拆分asset.js、borrow.js、system.js assets/ # 静态资源 components/ # 通用组件如UploadExcel、QrCodeModal composables/ # 组合式函数如usePagination、useUserInfo layout/ # 后台主布局侧边栏顶栏内容区 router/ # 路由配置 stores/ # Pinia状态管理 utils/ # axios封装、日期格式化、权限判断 views/ asset/ # 资产档案列表、新增、编辑 borrow/ # 借用管理、归还管理 system/ # 用户管理、角色管理 dashboard/ # 首页统计卡片与图表composables目录是Vue3组合式API带来的最大价值点。拿分页来说几乎每个列表页都有分页页码、每页条数、当前页数据、加载状态。把这一段抽成usePaginationexport function usePagination(fetchFn) { const list ref([]) const total ref(0) const loading ref(false) const page ref(1) const pageSize ref(10) async function loadData() { loading.value true try { const res await fetchFn({ page: page.value, pageSize: pageSize.value }) list.value res.data.records total.value res.data.total } finally { loading.value false } } function handlePageChange(p) { page.value p; loadData() } function handleSizeChange(s) { pageSize.value s; page.value 1; loadData() } return { list, total, loading, page, pageSize, loadData, handlePageChange, handleSizeChange } }资产列表页只需要拿到这个函数并传入请求方法就能获得完整的分页交互逻辑。这就是Vue3组合式API的魅力——同一套逻辑在多个页面复用而不是复制粘贴十遍。5.2 Axios封装与路由权限控制Axios封装有两点最容易出问题请求拦截器里加token响应拦截器里统一处理错误码和401状态。token一般存在localStorage或Pinia里每次请求时header中带上Authorization: Bearer ${token}。响应拦截器中如果后端返回了业务错误码要统一弹错误提示如果状态码是401说明登录过期要清理本地登录态并跳转登录页。路由守卫是权限控制的关键。Vue Router的beforeEach全局前置守卫里判断用户是否登录、是否有权限访问当前路由。第一层判断未登录跳转/login第二层判断登录后如果访问的管理员路由但当前用户不是管理员拦截并提示无权限。这套控制方式简单但有效适合资产系统这种权限粒度到“菜单/按钮”级别的管理后台。5.3 前后端联调时最容易卡住的三个问题联调阶段踩坑是常态我重点说三个高频问题。第一个是跨域。前端开发在5173端口后端在8080端口浏览器会拦截跨域请求。解决方案是后端写一个CorsConfig配置类允许指定来源跨域或者在后端Controller上加CrossOrigin。更工程化的方式是用Vite的proxy代理在vite.config.js中配置server: { proxy: { /api: { target: http://localhost:8080, changeOrigin: true } } }前端请求/api/asset/list时代理自动转发到http://localhost:8080/api/asset/list浏览器侧没有跨域问题后端也不需要额外配置。这种方式更适合生产环境前后端分离部署场景因为生产环境通常用Nginx转发同源请求。第二个是时间格式。后端返回的时间是2025-01-01T12:00:00这样的ISO格式前端如果不做格式化会直接显示成带“T”的字符串很难看。JS端直接用day.js或者后端在Jackson配置里写spring.jackson.date-formatyyyy-MM-dd HH:mm:ss、spring.jackson.time-zoneGMT8统一处理。第三个是枚举状态显示。后端返回的是数字状态码1、2、3前端表格直接显示数字会让人摸不着头脑。前端写一个映射字典{1: 在库, 2: 已领用, 3: 借出, 4: 维修中, 5: 已报废}再用Element Plus的tag组件按不同状态渲染不同颜色的标签。做好这个资产列表页的体验立刻上一个档次。6. 源码部署与常见翻车点从本地启动到联调上线的避坑参考最后把部署和运行有关的经验集中说一遍。这个项目源码拿回来后按照下面的准备步骤来会顺手很多。6.1 环境准备的最小组合JDK版本根据SpringBoot版本选择SpringBoot 2.x用JDK 8或11SpringBoot 3.x必须JDK 17以上。MySQL建议5.7或8.0。前端Node.js版本最好用16.18以上或者18Vite对Node版本有最低要求版本太老会直接启动报错。这些环境没有的话先去官网下载对应版本不要用系统自带的旧版本碰运气。启动前顺序建议先启动MySQL并导入SQL脚本然后启动后端SpringBoot最后启动前端Vue开发服务器。后端的标准启动方式是在项目根目录执行mvn spring-boot:run或者先打包成可执行Jarmvn clean package java -jar target/asset-system.jar前端启动npm install npm run dev本地跑通之后浏览器访问Vite输出的地址通常是http://localhost:5173看看登录页能不能正常打开。6.2 MySQL相关的高频问题连接、时区、编码与SSL第三章提过时区和字符集问题这里补充两个高频报错。第一个是Public Key Retrieval is not allowed原因是MySQL 8.0默认使用caching_sha2_password认证插件JDBC连接时需要在URL上加allowPublicKeyRetrievaltrue参数。第二个是SSL connection error解决办法是在URL上加useSSLfalse如果不加MySQL 8.0会尝试SSL连接本地开发环境没必要。这两个其实是同一个问题的两面连接串写全就不会碰到。如果你改了MySQL root用户密码记得同步修改application.yml里的数据库配置否则后端启动时会报Access denied。这个错误虽然低级但确实很多人遇到。6.3 MyBatis相关XML映射找不到与SQL日志不显示Invalid bound statement (not found)是这个项目里最常见的启动期报错之一。原因通常是Mapper接口和XML文件没有绑定成功。排查链路是这样的检查mybatis.mapper-locations是否指向了classpath:mapper/*.xml确认target/classes目录下有没有编译进去的XML文件如果用的SpringBoot 3.x还要确认mybatis-starter版本对应3.x。这其实也回应了热词里提到的mybatis中xmlconfigbuilser的工作流程图——MyBatis启动时通过XMLConfigBuilder解析全局配置再由MapperRegistry注册Mapper接口和XML语句绑定如果XML没被扫描到接口方法就找不到对应SQL。想要在控制台看到SQL日志除了第4章提到的log-impl: org.apache.ibatis.logging.stdout.StdOutImpl还需要配置日志级别。SpringBoot 2.x下在application.yml里加logging: level: com.example.asset.mapper: debug这样只有mapper包下的SQL才会打印debug日志不会刷屏排查问题又方便。6.4 数据一致性与事务细节借还操作不能只改一张表这个项目里最值得注意的“一致性”要求是任何涉及资产状态改变的操作都要同时写记录。借用、领用、归还、维修、报废全部是“资产表状态更新流水记录插入”的双写操作。Service层方法上必须加Transactional否则中途任何一步异常都可能造成状态和流水不一致。这个思路也适用于面试题里常问的“Java怎么保证数据一致性”——在本地事务层面最核心的答案就是事务边界要包住整个业务操作锁要加在真正并发冲突的读路径上。实测下来我建议你在代码里为每类操作都加一个OperationType配合操作日志表记录。比如资产状态被改了日志里要记录“谁在什么时间把什么资产从X状态改成了Y状态”。这不是为了炫技而是真实公司环境里出现纠纷时比如两个部门抢同一个设备操作系统里有账可查问题就能快速定位到人。6.5 拿到源码后的扩展思路如果你拿到源码后想加深理解或者用于毕设/项目展示我建议从这三个方向扩展。第一个方向是首页数据可视化。用ECharts或AntV展示资产分布按部门、按类别、按状态的图表再加上待盘点和借出未还的预警卡片。这一块前端工作量不小但视觉效果拉满能从“CRUD系统”直接升级到“数据可视化管理系统”。第二个方向是资产二维码标签。在资产档案中为每个资产生成二维码二维码内容指向该资产详情页。打印出来贴在设备上盘点时手机扫码就能查看资产信息。前端用qrcode库生成二维码后端提供资产详情接口即可。第三个方向是导入导出Excel。公司里资产管理的历史数据大多在Excel里系统上线时要支持批量导入。后端可以用EasyExcel或Apache POI读取Excel并逐行校验导出的报表格式也要和财务要求的模板一致。标题的热词里提到了“java poi word能生成图表吗”说明很多人在看POI相关技术这个方向同样是真实需求。这三个方向任选一个做深你的项目就会明显区别于普通的管理系统演示项目面试时也有更完整的叙事线。最后说一个我在实操中的体会技术栈本身并不难难的是把业务流程想清楚。这个项目如果你只是把它跑起来、点几个页面那你学到的东西很有限把它当成一个真实的公司内部系统去理解——为什么资产表要有状态冗余字段、为什么盘点要快照账面数据、为什么借还要加事务和行锁、为什么前端分页逻辑要抽成组合式函数——每一个设计决策背后都有对应的实际业务痛点。把这些想通了你以后再接手别的管理系统就有了一套可以复用的方法论。
公司资产网站系统全栈开发：SpringBoot+Vue3+MyBatis实战
在正式输出前我先梳理这篇文章的结构方案确保它不套用模板、贴合这个具体标题的价值点标题核心是什么一个可直接复现的“公司资产网站系统”全栈项目涉及SpringBoot、Vue3、MyBatis、MySQL、前后端分离。读者最需要知道什么这个系统解决什么业务、表结构怎么设计、后端核心接口怎么落、前端从Vue3项目初始化到联调有哪些坑、源码拿到后部署时有哪些容易翻车的地方。切入角度从一个实际场景引入——公司里资产登记还在用Excel借出去找不回来盘点靠肉眼这样这个项目的意义就自然立住了。按照直接开写、内容充实的原则组织章节名直接点出各阶段要解决的问题避免通用模板。下面输出正文。1. 管公司资产为什么需要一个网站系统先从业务场景说起大多数中小公司在资产管理上都没有正经系统。行政部门发一台笔记本电脑靠的是Excel登记员工拿到电脑后换部门、离职、硬盘坏了要维修系统里毫无记录行政只能靠问、靠翻聊天记录。到了年中盘点财务要核对资产原值行政要核对实物状态两边数据对不上最后只能“拍脑袋平账”。这个项目要解决的就是这一整条链路的数字化问题。标题里的“公司资产网站系统”本质上是一个资产全生命周期管理系统。所谓全生命周期指的是从资产入库开始到领用、借用、归还、维修、调拨、盘点、报废每个环节都有记录、有状态、有操作人、有时间戳。有了这些记录行政不再靠记忆管理资产财务做折旧和原值核销也有据可查老板看报表时能知道公司到底有多少家底、有多少资产闲置、多少资产在个人手里。从技术角度看这个系统又是一个特别典型的前后端分离全栈项目后端用SpringBoot提供REST接口前端用Vue3做单页应用持久层用MyBatis操作MySQL项目自带一套完整的源码结构适合做毕设、做内部管理系统的起点工程也适合正在学Java全栈的开发者拿来拆解。你拿到的不是“一个登录一个HelloWorld”而是带有真实业务含义的资产登记、二维码标签、领借还、盘点、权限管理这几个核心模块。我的建议是拿到源码先别急着启动运行先把这个项目的业务模型和表结构吃透。技术栈固然重要但这类管理系统最值钱的恰恰是数据建模和状态流转设计——后面的章节我会逐个拆开讲。2. 技术选型不是凑热闹SpringBootVue3MyBatis到底各自解决什么问题很多人看到“前后端分离Vue3SpringBoot”第一反应是“用的都是热门技术”但选型背后的逻辑很少有人说清楚。我按数据流的方向拆一下浏览器端是Vue3负责页面渲染和用户交互服务器端是SpringBoot负责业务逻辑和接口暴露数据库层MySQL存持久化数据而MyBatis夹在SpringBoot和MySQL之间专门负责SQL映射。2.1 为什么是SpringBoot而不是SSH或者Spring MVC先说后端。以前写Java Web用SSHStruts2SpringHibernate或者传统Spring MVC光是配置文件就能写一整天数据源配置、事务配置、扫描配置、视图解析器配置新手光是把环境跑起来就要折腾两三天。SpringBoot把这些繁琐的配置全部自动化和约定化application.yml里写上数据库连接信息引入依赖后它自己就知道怎么装配。对资产系统这种典型的CRUD事务场景SpringBoot的自动配置、Starter机制、内嵌Tomcat这三个特性非常合适——本地直接java -jar就能跑部署不需要额外装Tomcat。2.2 为什么选MyBatis而不是JPA这可能是这个项目里最值得琢磨的选型。资产管理系统里SQL并不复杂但存在大量“带条件的动态统计”按部门统计资产数量、按状态筛资产清单、按时间范围查借还记录、盘点单和盘点明细的多表关联。MyBatis对这类场景的优势非常明显SQL由你亲手控制动态SQL用if、where、foreach标签拼接该怎么查就怎么查性能可控排错直观。JPA/Hibernate虽然也能做但它更适合领域对象关系很重的业务而且一旦涉及多表联查和复杂统计要么你写JPQL要么用原生SQL反而不如MyBatis直接写XML来得顺手。再看面试时容易被问到的点——MyBatis的一级缓存、二级缓存、TypeHandler这些在这个项目里的Settings和TypeHandler配置中都有实际落脚点学完框架再看项目会非常有感觉。2.3 Vue3在这个项目里具体负责什么Vue3相比Vue2的核心变化是Composition API配合script setup语法组件逻辑组织比Options API清晰得多。资产系统有大量表单页面——新增资产、编辑资产、借用登记、归还登记——这些页面很多字段是重复的用Composition API把“表单校验逻辑”抽成公共的useAssetForm函数或者把“分页请求逻辑”抽成usePagination组合函数多个页面复用同一套逻辑代码量直接砍半。前端这块还牵扯到Vite、Element Plus组件库、Pinia状态管理、Axios请求封装、Vue Router动态路由。这些组合起来构建出的资产管理系统前端本质上是一个“后台管理系统”的典型形态。标题里既然带Vue3那就不是简单引入一下而已——你要能讲清楚页面是什么结构、路由守卫怎么控制权限、token怎么存、接口怎么封装。3. 数据库是地基资产系统MySQL表结构设计的核心关键点做管理系统技术写得再花哨表结构一塌糊涂照样白搭。我这里把项目中最重要的几张表拆解一下你对照源码中的SQL脚本看会非常清楚。3.1 核心表拆解与字段设计这个系统至少包含用户表、角色表、权限表、资产类别表、资产档案表、资产领用记录表、资产借还记录表、盘点任务表、盘点明细表、操作日志表这十张表。我挑资产档案表和借还记录表展开说。资产档案表asset_info的字段设计有几个关键点字段名类型说明idbigint主键自增asset_codevarchar(64)资产编号唯一索引建议格式ZC部门简码年月序列asset_namevarchar(128)资产名称如“ThinkPad X1 Carbon”asset_type_idbigint关联资产类别表specvarchar(255)规格型号snvarchar(128)出厂序列号很多公司忽略这个字段导致保修期到了不知道pricedecimal(10,2)资产原值财务折旧要用purchase_datedate购入日期statustinyint核心状态字段1在库、2已领用、3借出、4维修中、5已报废current_user_idbigint当前使用人这是极其重要的反范式设计locationvarchar(255)存放位置qr_codevarchar(255)二维码内容标签打印用create_timedatetime创建时间这里有两个容易被忽略的设计诀窍。第一个是status和current_user_id冗余在资产表上。表面上看当前使用人可以通过“领用记录”表的最新一条记录推导出来但资产列表页每页要显示几十条数据如果每次都去联查“最新记录”SQL写起来麻烦索引设计也复杂。直接在资产表上冗余这两个字段每次领用、借用、归还时在业务层同步更新查询就不需要子查询。空间换时间对管理系统是常见且务实的选择。第二个是资产编号asset_code必须加唯一索引。真实公司里资产编号就是资产的“身份证”Excel时代最常出现的问题是编号重复、漏编数据库层面挡住这个口子可以避免非常多的后续脏数据。盘点这个业务为什么要单拆两张表盘点任务表和盘点明细表因为盘点是一个“以账对物”的过程。盘点任务表记录某年某次的盘点范围、盘点人、盘点状态盘点明细表记录每个资产在本次盘点中的“账面状态”和“实际盘点状态”如果两者不一致就记为盘盈或盘亏。这里需要两个状态字段不能只存一个结果——因为财务后续要区分盘盈资产入账和盘亏资产报损处理逻辑完全不同。3.2 为什么字段类型要这样设计时间、金额、状态的实践选择时间字段统一用datetime而不是varchar这是硬性要求如果用varchar存时间排序会按字典序跨年时会排错而且MySQL的DATE_FORMAT、TIMESTAMPDIFF这些函数直接失效。金额用decimal(10,2)而不用float/doublefloat有精度损失对资产原值、折旧金额这种需要精确计算的数据来说是不可接受的。状态字段用tinyint而不是varchar存“在库”“借出”这样的中文文案——文案可以改变数字状态码稳定展示层去映射成中文就可以了。索引设计上asset_info表的status、department_id、purchase_date这些查询条件字段建议建普通索引因为资产列表页最常做的筛选就是“按状态看全部”“按部门看资产”。借还记录表则一定要建asset_id, create_time联合索引因为查询“某资产的历史借还流水”是最核心的查询路径。3.3 MySQL配置与导入时最常见的坑源码里一般会带一个asset_system.sql脚本。导入MySQL时最容易踩的坑有三个字符集、时区、sql_mode。脚本里最好显式写DEFAULT CHARSETutf8mb4否则插入emoji等情况会出现数据丢失数据库连接串务必带serverTimezoneAsia/Shanghai不然Java连接MySQL 8.x时会报时区错误这已经是老生常谈但每届新手都要踩一遍的坑MySQL 5.7及以上默认启用严格模式如果脚本中有不规范的默认值比如date字段直接默认空字符串导入时就会报错这时要么改脚本要么在my.cnf中调整sql_mode。提示这里先说一下方案的选择逻辑。数据库面向的核心是“状态查询和流转记录”所以反范式设计、状态机、流水表是主题而不用刻意追求教科书式的范式化那样对管理系统的查询性能反而是负担。4. 后端核心逻辑拆解SpringBoot工程结构与资产借还闭环实现后端工程建议以Maven构建包结构采用经典的controller/service/mapper/entity分层。controller层只做参数接收和结果封装service层做业务逻辑和事务控制mapper层只做数据库操作。这个分层看起来简单但很多刚从培训班出来的人写代码喜欢在controller里堆逻辑导致后面加一个“归还资产时同时生成日志记录”的需求都要改好几个方法。分层清晰以后加需求的时候定位就非常快。4.1 核心依赖配置与启动类pom.xml里必不可少的依赖包括spring-boot-starter-web、mybatis-spring-boot-starter、mysql-connector-j、lombok。这是后端跑起来的最基本组合。特别提醒mybatis-spring-boot-starter的版本要和SpringBoot版本匹配SpringBoot 2.x对应mybatis-starter 2.xSpringBoot 3.x对应mybatis-starter 3.x如果版本不对最常见的问题就是启动时找不到SqlSessionFactory。application.yml里的几个关键点spring: datasource: url: jdbc:mysql://localhost:3306/asset_system?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue username: root password: yourpassword driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.asset.entity configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImplmap-underscore-to-camel-casetrue这一段非常关键。如果数据库字段是create_time而Java实体属性是createTime没有这个配置的话查询结果映射出来就是null。log-impl配置成StdOutImpl可以把MyBatis执行的SQL打印到控制台调试时直接看SQL是很爽的排查N1问题、参数传递问题都靠这个。4.2 资产借用与归还状态流转和事务控制的核心资产借用是资产系统里业务逻辑最典型的一个模块。我先说流程员工提交借用申请填写借用资产、预计归还时间管理员审批后资产状态由“在库”改为“借出”同时在借还记录表中插入一条记录归还时管理员确认资产状况状态改为“在库”更新借还记录的归还时间。这个流程放到代码里就是两个数据库操作协同更新资产状态插入借还记录。这两个操作必须放在同一个事务里否则可能出现资产状态改了但流水没记上或者流水记了但资产状态没改。实现方式就是Service层方法上加Transactional注解。借用的Service方法大概长这样Transactional(rollbackFor Exception.class) public void borrowAsset(BorrowDTO dto) { AssetInfo asset assetMapper.selectByIdForUpdate(dto.getAssetId()); if (asset null || asset.getStatus() ! 1) { throw new BizException(该资产当前不可借用); } asset.setStatus(3); asset.setCurrentUserId(dto.getUserId()); assetMapper.updateById(asset); BorrowRecord record new BorrowRecord(); record.setAssetId(dto.getAssetId()); record.setUserId(dto.getUserId()); record.setBorrowTime(new Date()); record.setExpectReturnTime(dto.getExpectReturnTime()); record.setStatus(1); borrowRecordMapper.insert(record); }这里有一个关键操作selectByIdForUpdate。这个“ForUpdate”是行级锁它的作用是在并发情况下两个人同时操作同一个资产时后者必须等前者事务提交后才能读到数据。没有这把锁的话两台电脑同时点击“借用成功”资产状态可能被覆盖记录也可能乱掉。这属于典型的并发控制问题如果面试官问起“数据一致性怎么保证”这是一个很实在的回答素材。归还逻辑同理先校验借还记录的合法性把该资产的状态还原为在库同时更新记录状态和实际归还时间。归还时建议顺带记录资产外观状况字段比如“正常/有磨损/部件缺失”这个信息对后续维修和报废判断非常有用。4.3 盘点流程的状态机设计盘点流程也是一个状态机创建盘点任务状态为待盘点→ 盘点人逐项确认资产状态变为已盘→ 完成盘点状态为已完成 → 生成盘盈盘亏明细。这里实现上的一个关键点是盘点单明细表中的“账面状态”是在创建盘点任务时从资产表快照复制过去的不是动态联查的。为什么因为盘点本身就是核对账实是否一致如果所有数据都动态查当前库资产中间变了就说不清了快照才能还原“盘点当时”的账面情况后面做差异分析才有依据。4.4 MyBatis的XML映射与动态SQL写法Mapper的XML文件是这个项目的核心资产之一。资产列表页往往需要多条件筛选按名称模糊查询、按类别、按状态、按购入日期范围。用动态SQL写select idselectByCondition resultTypecom.example.asset.entity.AssetInfo select * from asset_info where if testname ! null and name ! and asset_name like concat(%, #{name}, %) /if if testassetTypeId ! null and asset_type_id #{assetTypeId} /if if teststatus ! null and status #{status} /if if testpurchaseDateBegin ! null and purchase_date gt; #{purchaseDateBegin} /if if testpurchaseDateEnd ! null and purchase_date lt; #{purchaseDateEnd} /if /where order by create_time desc /selectwhere标签会自动处理“第一个条件前的and”问题你写的条件再多也不用担心拼接出where and status 1这种SQL。注意和在XML里必须转义成gt;和lt;这是XML映射文件中特别容易报错的地方——很多新手在这里卡半小时编译器提示“元素内容必须由格式正确的字符数据或标记组成”其实就是小于号没转义。关于MyBatis的一级二级缓存在这个管理系统场景里我的建议是查低频数据的场景可以开二级缓存但资产表这种频繁更新状态的表不建议开。因为任何一次状态更新都会导致缓存失效频繁失效反而降低性能而且资产状态读到的若是脏数据可能让管理员误判。默认关闭就好不要把缓存当万能药。5. Vue3前端落地从项目初始化到前后端联调的完整路径标题里既然带Vue3前端这部分就要真正讲透。项目建议用Vite作为构建工具初始化创建命令npm create vuelatest这个脚手架会询问你是否需要Vue Router、Pinia、ESLint等资产管理系统按需选择需要Router、需要Pinia测试和ESLint看个人习惯。为什么用Vite而不用WebpackVite基于ESModule冷启动速度极快几秒钟就能起来开发体验比Webpack好得多生产构建是通过Rollup打包产物质量和体积也可控。5.1 前端工程目录结构与核心模块职责建议的目录结构是这样src/ api/ # 接口请求封装按模块拆分asset.js、borrow.js、system.js assets/ # 静态资源 components/ # 通用组件如UploadExcel、QrCodeModal composables/ # 组合式函数如usePagination、useUserInfo layout/ # 后台主布局侧边栏顶栏内容区 router/ # 路由配置 stores/ # Pinia状态管理 utils/ # axios封装、日期格式化、权限判断 views/ asset/ # 资产档案列表、新增、编辑 borrow/ # 借用管理、归还管理 system/ # 用户管理、角色管理 dashboard/ # 首页统计卡片与图表composables目录是Vue3组合式API带来的最大价值点。拿分页来说几乎每个列表页都有分页页码、每页条数、当前页数据、加载状态。把这一段抽成usePaginationexport function usePagination(fetchFn) { const list ref([]) const total ref(0) const loading ref(false) const page ref(1) const pageSize ref(10) async function loadData() { loading.value true try { const res await fetchFn({ page: page.value, pageSize: pageSize.value }) list.value res.data.records total.value res.data.total } finally { loading.value false } } function handlePageChange(p) { page.value p; loadData() } function handleSizeChange(s) { pageSize.value s; page.value 1; loadData() } return { list, total, loading, page, pageSize, loadData, handlePageChange, handleSizeChange } }资产列表页只需要拿到这个函数并传入请求方法就能获得完整的分页交互逻辑。这就是Vue3组合式API的魅力——同一套逻辑在多个页面复用而不是复制粘贴十遍。5.2 Axios封装与路由权限控制Axios封装有两点最容易出问题请求拦截器里加token响应拦截器里统一处理错误码和401状态。token一般存在localStorage或Pinia里每次请求时header中带上Authorization: Bearer ${token}。响应拦截器中如果后端返回了业务错误码要统一弹错误提示如果状态码是401说明登录过期要清理本地登录态并跳转登录页。路由守卫是权限控制的关键。Vue Router的beforeEach全局前置守卫里判断用户是否登录、是否有权限访问当前路由。第一层判断未登录跳转/login第二层判断登录后如果访问的管理员路由但当前用户不是管理员拦截并提示无权限。这套控制方式简单但有效适合资产系统这种权限粒度到“菜单/按钮”级别的管理后台。5.3 前后端联调时最容易卡住的三个问题联调阶段踩坑是常态我重点说三个高频问题。第一个是跨域。前端开发在5173端口后端在8080端口浏览器会拦截跨域请求。解决方案是后端写一个CorsConfig配置类允许指定来源跨域或者在后端Controller上加CrossOrigin。更工程化的方式是用Vite的proxy代理在vite.config.js中配置server: { proxy: { /api: { target: http://localhost:8080, changeOrigin: true } } }前端请求/api/asset/list时代理自动转发到http://localhost:8080/api/asset/list浏览器侧没有跨域问题后端也不需要额外配置。这种方式更适合生产环境前后端分离部署场景因为生产环境通常用Nginx转发同源请求。第二个是时间格式。后端返回的时间是2025-01-01T12:00:00这样的ISO格式前端如果不做格式化会直接显示成带“T”的字符串很难看。JS端直接用day.js或者后端在Jackson配置里写spring.jackson.date-formatyyyy-MM-dd HH:mm:ss、spring.jackson.time-zoneGMT8统一处理。第三个是枚举状态显示。后端返回的是数字状态码1、2、3前端表格直接显示数字会让人摸不着头脑。前端写一个映射字典{1: 在库, 2: 已领用, 3: 借出, 4: 维修中, 5: 已报废}再用Element Plus的tag组件按不同状态渲染不同颜色的标签。做好这个资产列表页的体验立刻上一个档次。6. 源码部署与常见翻车点从本地启动到联调上线的避坑参考最后把部署和运行有关的经验集中说一遍。这个项目源码拿回来后按照下面的准备步骤来会顺手很多。6.1 环境准备的最小组合JDK版本根据SpringBoot版本选择SpringBoot 2.x用JDK 8或11SpringBoot 3.x必须JDK 17以上。MySQL建议5.7或8.0。前端Node.js版本最好用16.18以上或者18Vite对Node版本有最低要求版本太老会直接启动报错。这些环境没有的话先去官网下载对应版本不要用系统自带的旧版本碰运气。启动前顺序建议先启动MySQL并导入SQL脚本然后启动后端SpringBoot最后启动前端Vue开发服务器。后端的标准启动方式是在项目根目录执行mvn spring-boot:run或者先打包成可执行Jarmvn clean package java -jar target/asset-system.jar前端启动npm install npm run dev本地跑通之后浏览器访问Vite输出的地址通常是http://localhost:5173看看登录页能不能正常打开。6.2 MySQL相关的高频问题连接、时区、编码与SSL第三章提过时区和字符集问题这里补充两个高频报错。第一个是Public Key Retrieval is not allowed原因是MySQL 8.0默认使用caching_sha2_password认证插件JDBC连接时需要在URL上加allowPublicKeyRetrievaltrue参数。第二个是SSL connection error解决办法是在URL上加useSSLfalse如果不加MySQL 8.0会尝试SSL连接本地开发环境没必要。这两个其实是同一个问题的两面连接串写全就不会碰到。如果你改了MySQL root用户密码记得同步修改application.yml里的数据库配置否则后端启动时会报Access denied。这个错误虽然低级但确实很多人遇到。6.3 MyBatis相关XML映射找不到与SQL日志不显示Invalid bound statement (not found)是这个项目里最常见的启动期报错之一。原因通常是Mapper接口和XML文件没有绑定成功。排查链路是这样的检查mybatis.mapper-locations是否指向了classpath:mapper/*.xml确认target/classes目录下有没有编译进去的XML文件如果用的SpringBoot 3.x还要确认mybatis-starter版本对应3.x。这其实也回应了热词里提到的mybatis中xmlconfigbuilser的工作流程图——MyBatis启动时通过XMLConfigBuilder解析全局配置再由MapperRegistry注册Mapper接口和XML语句绑定如果XML没被扫描到接口方法就找不到对应SQL。想要在控制台看到SQL日志除了第4章提到的log-impl: org.apache.ibatis.logging.stdout.StdOutImpl还需要配置日志级别。SpringBoot 2.x下在application.yml里加logging: level: com.example.asset.mapper: debug这样只有mapper包下的SQL才会打印debug日志不会刷屏排查问题又方便。6.4 数据一致性与事务细节借还操作不能只改一张表这个项目里最值得注意的“一致性”要求是任何涉及资产状态改变的操作都要同时写记录。借用、领用、归还、维修、报废全部是“资产表状态更新流水记录插入”的双写操作。Service层方法上必须加Transactional否则中途任何一步异常都可能造成状态和流水不一致。这个思路也适用于面试题里常问的“Java怎么保证数据一致性”——在本地事务层面最核心的答案就是事务边界要包住整个业务操作锁要加在真正并发冲突的读路径上。实测下来我建议你在代码里为每类操作都加一个OperationType配合操作日志表记录。比如资产状态被改了日志里要记录“谁在什么时间把什么资产从X状态改成了Y状态”。这不是为了炫技而是真实公司环境里出现纠纷时比如两个部门抢同一个设备操作系统里有账可查问题就能快速定位到人。6.5 拿到源码后的扩展思路如果你拿到源码后想加深理解或者用于毕设/项目展示我建议从这三个方向扩展。第一个方向是首页数据可视化。用ECharts或AntV展示资产分布按部门、按类别、按状态的图表再加上待盘点和借出未还的预警卡片。这一块前端工作量不小但视觉效果拉满能从“CRUD系统”直接升级到“数据可视化管理系统”。第二个方向是资产二维码标签。在资产档案中为每个资产生成二维码二维码内容指向该资产详情页。打印出来贴在设备上盘点时手机扫码就能查看资产信息。前端用qrcode库生成二维码后端提供资产详情接口即可。第三个方向是导入导出Excel。公司里资产管理的历史数据大多在Excel里系统上线时要支持批量导入。后端可以用EasyExcel或Apache POI读取Excel并逐行校验导出的报表格式也要和财务要求的模板一致。标题的热词里提到了“java poi word能生成图表吗”说明很多人在看POI相关技术这个方向同样是真实需求。这三个方向任选一个做深你的项目就会明显区别于普通的管理系统演示项目面试时也有更完整的叙事线。最后说一个我在实操中的体会技术栈本身并不难难的是把业务流程想清楚。这个项目如果你只是把它跑起来、点几个页面那你学到的东西很有限把它当成一个真实的公司内部系统去理解——为什么资产表要有状态冗余字段、为什么盘点要快照账面数据、为什么借还要加事务和行锁、为什么前端分页逻辑要抽成组合式函数——每一个设计决策背后都有对应的实际业务痛点。把这些想通了你以后再接手别的管理系统就有了一套可以复用的方法论。
