简介基于Spring Boot与MySQL打造的财务管理系统完整项目面向计算机相关专业毕业设计、课程设计及需要快速搭建财务管理系统的开发者。系统支持收入、支出、资产、负债等财务数据的录入、编辑与查询并涵盖会计科目管理、预算编制与执行监控、三大报表生成、财务审批流程、数据统计与备份恢复等核心模块界面友好且注重数据安全适合作为学习Spring Boot整合MySQL的实战案例。压缩包整体约17.76MB包含项目源码、设计文档、部署说明及视频演示源码经过测试校正可百分百成功运行设计文档便于理解系统架构与数据库设计部署说明和视频则能降低上手门槛。目前已有232人学习下载适合需要完整方案完成课设、毕设或快速落地财务管理功能的读者。1. 财务管理系统为什么值得用Springbootmysql重写毕业设计之外的落地价值做过财务软件相关需求的人都知道这类系统真正的难点不在页面好不好看而在「一笔凭证下去科目余额、明细账、总账能不能同时对上」。用Springbootmysql做财务管理系统恰好踩在业务复杂度和技术可控性的交叉点上Springboot负责把权限、凭证录入、审核、报表这些流程编排清楚mysql负责把每一笔账以结构化方式落库让月末对账从「肉眼盯Excel」变成「一条SQL出结果」。这个标题对应的是一套完整的交付物——源码、设计文档、部署说明、视频演示都齐意味着作者希望读者拿到的不只是能跑的项目而是能看懂、能改、能答辩、能讲清楚的设计闭环。适合谁看准备做Java web课程设计或毕业设计的在校生、打算给中小团队搭一套轻量财务工具的后端开发以及想快速了解「Springbootmysql这类管理系统通用套路」的初学者。接下来我按「先立数据库、再串业务、后讲部署坑」的顺序把这条链路完整拆开。2. 财务系统的数据库设计从科目表到凭证流水先把表结构立住2.1 会计科目的层级设计与编码规则财务系统的地基不是用户表是科目表。所有凭证、明细账、余额表都得挂靠在科目上科目设计得乱后面报表全得返工。常见的做法是采用「科目编码 层级标记」两级结构一级科目对应会计准则里的大类资产、负债、权益、成本、损益二级科目往下拆具体明细。需要注意的是科目编码不建议用自增id做主键因为科目编码本身就是业务键比如资产类以1开头、负债类以2开头转账时只看编码就能判断科目方向。我一般会这样建表科目表带parent_id做自关联同时冗余一个level字段区分一级二级方便查询时不用递归。编码统一用varchar不要用int因为「1001」这种带前导零的编码在int里会被截断成1001没问题但「0101」这种就会丢零。实际项目中踩过某张表的会计科目编码设计成int导入老系统的Excel数据时所有以0开头的二级科目全变了最后只能靠补零脚本救回来。教训就是编码这类字段一律字符串长度按需求定一般varchar(20)够用。2.2 凭证、明细账与余额表的三种落库方式做过账务系统的人应该都纠结过凭证录入之后要不要实时去更新余额表这里有三种主流方案取舍点在于「查询效率」和「数据一致性」哪个优先。方案实现思路优点缺点适用场景每次查询时实时聚合不单独建余额表查询时对凭证明细做sum聚合不冗余绝对一致数据量大时查询慢报表卡顿演示项目、凭证量极小的系统录入凭证后同步更新余额表事务内同时写凭证表和余额表查询快余额实时准确需要小心处理作废、冲销否则余额会翻车中小型财务系统最常见定时任务批量汇总每晚跑批从凭证明细重算余额实现简单不占事务时间余额非实时当天报表不准对实时性要求不高的决策分析库这套系统的主链路建议用第二种凭证表只存流水余额表存科目当前借贷方累计发生额和期末余额录入凭证时在一个事务里同时更新。注意冲销场景红字凭证相当于反向分录如果余额表只做累加、不做方向判断冲销之后余额就错了。所以更新余额的逻辑里要判断借贷方向借方正数、贷方负数再做累计。2.3 初始化SQL建库、建表与索引的参考写法为了避免拿到源码后连库都建不出来初始化脚本最好一次跑通。下面是一个最小可用的建表集合覆盖用户、角色、科目、凭证、凭证明细、余额六张表。注意我写的都是核心字段实际项目还会加create_time、update_time这类审计字段。-- 财务管理系统核心表初始化脚本mysql 5.7/8.0 均适用 CREATE DATABASE IF NOT EXISTS finance DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE finance; -- 用户表 CREATE TABLE sys_user ( id BIGINT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL COMMENT BCrypt或MD5加盐后的密文, real_name VARCHAR(50) DEFAULT NULL, role_id BIGINT DEFAULT NULL COMMENT 角色id简单RBAC可省去用户角色关联表 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 会计科目表 CREATE TABLE acc_subject ( id BIGINT PRIMARY KEY AUTO_INCREMENT, code VARCHAR(20) NOT NULL COMMENT 科目编码如1001, name VARCHAR(50) NOT NULL COMMENT 科目名称, parent_id BIGINT DEFAULT NULL COMMENT 父科目id顶级为NULL, level TINYINT NOT NULL DEFAULT 1 COMMENT 级次1一级 2二级, direction TINYINT NOT NULL COMMENT 余额方向1借 -1贷, UNIQUE KEY uk_code (code) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 记账凭证表主表 CREATE TABLE acc_voucher ( id BIGINT PRIMARY KEY AUTO_INCREMENT, voucher_no VARCHAR(30) NOT NULL COMMENT 凭证号如记-2025-001, voucher_date DATE NOT NULL COMMENT 记账日期, status TINYINT NOT NULL DEFAULT 0 COMMENT 0草稿 1已审核 2已作废, creator_id BIGINT DEFAULT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_voucher_no (voucher_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 凭证明细表分录表 CREATE TABLE acc_voucher_detail ( id BIGINT PRIMARY KEY AUTO_INCREMENT, voucher_id BIGINT NOT NULL COMMENT 所属凭证, subject_id BIGINT NOT NULL COMMENT 科目id, summary VARCHAR(200) DEFAULT NULL COMMENT 摘要, debit_amount DECIMAL(14,2) NOT NULL DEFAULT 0.00, credit_amount DECIMAL(14,2) NOT NULL DEFAULT 0.00, KEY idx_voucher (voucher_id), KEY idx_subject (subject_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 科目余额表 CREATE TABLE acc_subject_balance ( id BIGINT PRIMARY KEY AUTO_INCREMENT, subject_id BIGINT NOT NULL, period VARCHAR(7) NOT NULL COMMENT 账期格式YYYY-MM, begin_balance DECIMAL(14,2) NOT NULL DEFAULT 0.00, debit_total DECIMAL(14,2) NOT NULL DEFAULT 0.00 COMMENT 本期借方发生额, credit_total DECIMAL(14,2) NOT NULL DEFAULT 0.00 COMMENT 本期贷方发生额, end_balance DECIMAL(14,2) NOT NULL DEFAULT 0.00, UNIQUE KEY uk_subject_period (subject_id, period) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这段SQL里最关键的是acc_subject_balance的唯一键uk_subject_period一个科目在一个账期只能有一条余额记录更新时用INSERT ... ON DUPLICATE KEY UPDATE或先查后改。direction字段记录科目余额方向算期末余额时直接用begin_balance 借方发生额 - 贷方发生额还是反过来取决于这个字段。另外凭证明细表的两个金额字段分别为debit_amount和credit_amount不要合并成一个amount direction虽然也能做但查询按借方、贷方分别汇总时会多写条件而且很多报表组件对双列更友好。3. 用Springboot把权限与核心账务流程串起来接口设计与关键代码3.1 项目分层与依赖模块划分与pom配置拿到源码后先别急着跑先看pom.xml里的依赖是不是完整。一个基于Springboot的财务管理系统核心依赖就四类web、持久层、数据库驱动、连接池。网上很多项目翻车都翻在版本不对——springboot 2.x 对应mybatis-spring-boot-starter2.xspringboot 3.x 必须用 mybatis starter 3.x混用会直接启动报错。!-- pom.xml 核心依赖片段springboot 版本以 2.7.x 为例 -- parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version relativePath/ /parent dependencies !-- web 启动器 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- mybatis 持久层注意版本要与 springboot 2.x 匹配 -- dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version2.3.2/version /dependency !-- mysql 驱动8.x 对应 com.mysql.cj.jdbc.Driver -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency !-- druid 连接池可选也可用 hikarispringboot 默认 -- dependency groupIdcom.alibaba/groupId artifactIddruid-spring-boot-starter/artifactId version1.2.20/version /dependency /dependencies注意 mysql 驱动这里有个经典坑springboot 2.7.x 的依赖管理里如果没有显式写版本号会默认拉到 8.0.x 的驱动对应的driver-class-name必须是com.mysql.cj.jdbc.Driver老教程里写的com.mysql.jdbc.Driver在 8.x 驱动下会提示Loading class com.mysql.jdbc.Driver ... is deprecated。如果你拿到的是 mysql 5.7 的库驱动用 8.x 也能连但useSSL和时区参数必须配好否则连上也会在查询时报错。3.2 登录与RBAC权限拦截器自定义注解的最小实现财务系统的权限不用做得太重但也不能裸奔。最实用的组合是HandlerInterceptor 自定义注解登录接口放行其余接口统一过拦截器校验token或session里的用户身份再用注解标记哪些接口需要特定角色。Spring Security 功能全但对这种单体管理系统来说学习成本和配置成本都偏高拦截器方案足够而且面试时更好讲清楚。// AuthRequired.java —— 自定义权限注解 Target({ElementType.METHOD, ElementType.TYPE}) Retention(RetentionPolicy.RUNTIME) public interface AuthRequired { // 允许访问的角色编码为空表示登录即可 String[] roles() default {}; }// AuthInterceptor.java —— 登录与角色校验拦截器 Component public class AuthInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { // 非控制器方法直接放行避免静态资源被拦 if (!(handler instanceof HandlerMethod)) { return true; } HandlerMethod handlerMethod (HandlerMethod) handler; AuthRequired auth handlerMethod.getMethodAnnotation(AuthRequired.class); if (auth null) { return true; // 没加注解的接口不做权限拦截 } // 从 session 或 header 取用户信息这里以 session 为例 HttpSession session request.getSession(); Object userId session.getAttribute(userId); if (userId null) { response.setStatus(401); response.setContentType(application/json;charsetUTF-8); response.getWriter().write({\code\:401,\msg\:\未登录\}); return false; } // 角色校验实际项目从数据库查角色编码 String userRole (String) session.getAttribute(roleCode); String[] needRoles auth.roles(); if (needRoles.length 0 !Arrays.asList(needRoles).contains(userRole)) { response.setStatus(403); response.setContentType(application/json;charsetUTF-8); response.getWriter().write({\code\:403,\msg\:\无权限\}); return false; } return true; } }这段代码的逻辑分三层先判断是不是控制器方法避免静态资源被拦截器误伤再检查方法上有没有AuthRequired注解没有就直接放行最后校验登录态和角色。注意角色判断用contains而不是equals因为一个方法可能允许多个角色访问。拦截器注册别忘了在WebMvcConfigurer里addInterceptors只写拦截器类不注册等于白写。3.3 凭证录入与复式记账事务边界怎么划财务系统最核心的功能就是凭证录入它的业务规则是「有借必有贷借贷必相等」。在代码层面这意味着一次凭证录入必须同时写acc_voucher主表和acc_voucher_detail明细表并且更新acc_subject_balance余额表。如果其中一步失败整个操作必须回滚否则就会出现「凭证主表有记录明细只有一半」的脏数据。这里的实现要点是把事务边界划在 service 层并且注意Transactional的生效条件。// VoucherService.java —— 凭证录入与过账 Service public class VoucherService { Autowired private VoucherMapper voucherMapper; Autowired private VoucherDetailMapper detailMapper; Autowired private SubjectBalanceMapper balanceMapper; Transactional(rollbackFor Exception.class) public Long createVoucher(VoucherDTO dto) { // 1. 校验借贷平衡 BigDecimal debitSum dto.getDetails().stream() .map(VoucherDetailDTO::getDebitAmount) .reduce(BigDecimal.ZERO, BigDecimal::add); BigDecimal creditSum dto.getDetails().stream() .map(VoucherDetailDTO::getCreditAmount) .reduce(BigDecimal.ZERO, BigDecimal::add); if (debitSum.compareTo(creditSum) ! 0) { throw new BusinessException(借贷金额不平衡无法保存); } // 2. 插入凭证主表返回自增id AccVoucher voucher new AccVoucher(); voucher.setVoucherNo(buildVoucherNo(dto.getVoucherDate())); voucher.setVoucherDate(dto.getVoucherDate()); voucher.setStatus(0); // 草稿状态 voucherMapper.insert(voucher); Long voucherId voucher.getId(); // 3. 批量插入明细逐条关联主表id for (VoucherDetailDTO item : dto.getDetails()) { AccVoucherDetail detail new AccVoucherDetail(); detail.setVoucherId(voucherId); detail.setSubjectId(item.getSubjectId()); detail.setSummary(item.getSummary()); detail.setDebitAmount(item.getDebitAmount()); detail.setCreditAmount(item.getCreditAmount()); detailMapper.insert(detail); // 4. 累加更新余额表这里简化只更新本期发生额 balanceMapper.accumulate(voucherId, item.getSubjectId(), item.getDebitAmount(), item.getCreditAmount(), getPeriod(dto.getVoucherDate())); } return voucherId; } }事务的边界是整个方法createVoucher里所有数据库操作要么全成功要么全回滚。rollbackFor Exception.class必须写否则默认只在RuntimeException时回滚自定义的BusinessException如果继承的是Exception不会触发回滚这是很多初学者最容易踩的坑。另外要注意Transactional在同一类内部方法调用时不生效比如VoucherService里另一个方法直接调this.createVoucher(...)事务会失效。解决方式是分开两个 service或者把被调方法放在另一个 bean 里。3.4 报表查询余额汇总的SQL与内存计算取舍凭证录入做完接下来就是报表。利润表、资产负债表的核心数据来源是「科目余额表」也就是acc_subject_balance这张表。查询时最忌讳把所有明细捞到内存里再算数据量一大就卡死。正确姿势是把汇总逻辑写在 SQL 里让 mysql 帮你算。下面这段是查某个月所有一级科目的期末余额因为二级科目余额要往上汇总到一级科目所以用SUBSTRING(code, 1, 4)按编码前四位分组。这是一种偷懒但有效的做法前提是科目编码规则规范——一级科目固定四位。-- 按月汇总一级科目期末余额 SELECT s.code AS subject_code, s.name AS subject_name, MAX(s.direction) AS direction, SUM(b.begin_balance) AS begin_balance, SUM(b.debit_total) AS debit_total, SUM(b.credit_total) AS credit_total, -- 期末余额 期初 借 - 贷方向为借时方向为贷时公式反过来 CASE WHEN MAX(s.direction) 1 THEN SUM(b.begin_balance b.debit_total - b.credit_total) ELSE SUM(b.begin_balance - b.debit_total b.credit_total) END AS end_balance FROM acc_subject_balance b JOIN acc_subject s ON b.subject_id s.id WHERE b.period 2025-06 GROUP BY s.code, s.name ORDER BY s.code;这段 SQL 的关键点是direction字段和CASE WHEN配合把「借方向科目」和「贷方向科目」的余额计算统一在一句查询里。如果科目编码不规整没法用SUBSTRING分组那就在acc_subject表里加一个root_code字段录入科目时直接存一级科目编码查询时用JOIN ... ON b.subject_id s2.id AND s2.root_code s.code性能更好也避免「编码规范」成为系统脆弱点。4. 部署与交付避坑从Windows到Linuxmysql版本与连接池的五个翻车现场4.1 现象mysql 8.0连接报 Public Key Retrieval is not allowed用 Springboot 连接 mysql 8.0 时启动或首次查询就报Public Key Retrieval is not allowed。原因是 mysql 8.0 默认认证插件是caching_sha2_password客户端第一次连接需要向服务端请求公钥做 RSA 加密而 JDBC 驱动默认不允许这个行为。解决方式有两种一是在 JDBC URL 后加allowPublicKeyRetrievaltrue二是把 mysql 用户的认证插件改回mysql_native_password。我建议先改 URL因为改用户认证插件会影响其他客户端。完整的 JDBC URL 参考spring.datasource.urljdbc:mysql://localhost:3306/finance?useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltruecharacterEncodingutf8 spring.datasource.usernameroot spring.datasource.passwordyour_password spring.datasource.driver-class-namecom.mysql.cj.jdbc.DriveruseSSLfalse是因为本地开发和内网部署一般不需要加密连接不关掉的话 mysql 8.0 会强制 SSL 握手慢且容易告警。serverTimezone必须设否则默认用 JVM 时区遇到CST这种歧义时区会出现时间偏移。4.2 现象mysql 5.7 升级到 8.0 后日期错一天有次在 windows 本机 mysql 5.7.44 上跑得好好的换到阿里云 mysql 8.0 后查询出的日期全部比数据库里的实际值早 8 小时。原因不是数据错了而是连接参数里没配serverTimezone驱动用 UTC 解析了DATETIME字段再转回东八区显示时就偏移了。解决办法就是 URL 里显式加上serverTimezoneAsia/Shanghai。如果还不对检查 mysql 服务端时区SELECT global.time_zone, session.time_zone;如果值是SYSTEM再看操作系统时区是不是 UTC。容器部署时尤其容易遇到这个问题。4.3 现象Transactional 加了但事务不生效数据照样写进去了模拟一个场景凭证录入接口前端传了 10 条明细因为网络原因请求超时用户又点了一次提交结果数据库里出现了两笔相同的凭证。代码里明明加了Transactional为什么没拦住排查步骤先看 service 类是不是被 Spring 代理——如果方法是private的或者通过this在同类内部调用事务注解会被忽略。再确认spring-boot-starter-web是否引入了事务管理依赖答案是不需要单独引spring-boot 自动配置了DataSourceTransactionManager。最常见的坑是Controller 里直接调 service 的私有方法或者两个 service 方法互相调。4.4 现象springboot 启动失败Port 8080 was already in use跑一个 springboot 项目时控制台报Web server failed to start. Port 8080 was already in use。尤其在 windows 上mysql 的某些监控工具或其它 java 进程可能占据 8080 端口。最快的处置方式不是改代码而是把 springboot 的server.port从8080改成8081然后继续用。用如下命令看是谁占了端口# Windows 查看端口占用 netstat -ano | findstr :8080 # 输出最后一列是 PID再查进程名 tasklist | findstr PID # Linux / macOS 查看端口占用 lsof -i :8080找到占用进程后确认不是系统服务再结束它。注意不要把 mysql 的 3306 端口和 springboot 的 8080 混为一谈它们没关系。如果你的项目里配置了 Druid 监控页且端口和应用端口冲突那就是server.port和druid.stat.view.servlet.urlPatterns的上下文路径问题不是同一个端口别被报错信息带偏。4.5 现象打包后在服务器上 java -jar 运行报「没有主清单属性」本地 IDE 里能启动package成 jar 后扔到服务器执行java -jar finance.jar报no main manifest attribute。原因不是你的 main 方法丢了而是 spring-boot-maven-plugin 没有配置或没生效。它负责把Main-Class和依赖的Class-Path写进 MANIFEST.MF没有它打出来的就是一个普通 jar而不是可执行 fat jar。检查pom.xml!-- spring-boot-maven-plugin 必须放在 build 里 -- build plugins plugin groupIdorg.springframework.boot/groupId artifactIdspring-boot-maven-plugin/artifactId /plugin /plugins /build如果配置了还报错检查是不是用了skiptrue/skip或者你的主类不在默认扫描路径。还有一种情况用mvn package打的是xxx.jar.original和xxx.jar两个文件前者是瘦包没有依赖后者才是 fat jar部署时选对文件。4.6 现象mysql 8.0.46 在 windows 上 net start mysql 一直「服务正在启动」热词里频繁出现mysql 服务正在启动半路失败这必须单独说一下用 zip 方式安装 mysql 8.0.46 时net start mysql之前必须先用管理员命令行执行mysqld --initialize-insecure初始化数据目录这步不做服务根本起不来。报错日志去mysql 安装目录\data\下的.err文件里看最常见的错误是Cant create/write to file改 data 目录权限或重新指定basedir、datadir就可以。5. 收尾验收把设计文档、部署说明和视频演示对齐这个项目才算交付源码能跑只是第一步一套合格的交付物必须让另外一个人按文档也能复现。这里我给一个可执行的验收方法先按设计文档里的数据库设计章节在干净的 mysql 实例上重新跑一遍初始化脚本看能不能建库成功再按部署说明里的步骤启动 springboot用文档里给的测试账号登录按视频演示的顺序操作一遍。如果每一步都能走通说明交付是自洽的。视频演示不要录成「鼠标乱点一小时」按功能模块拆成 3 分钟内的短视频更有效第一条录登录和权限控制证明不同角色看到的功能不同第二条录凭证录入、审核、作废全流程重点展示借贷平衡校验第三条录报表查询搜索某个账期的利润表或资产负债表展示汇总结果和凭证明细能对上。录制前先把演示数据准备好比如录 6 个月的凭证这样报表不是空的答辩或给客户演示时说服力强很多。最后提一下代码层面的验证手段用curl或 Postman 直接打接口跳过前端页面验证后端是否健壮。比如凭证录入接口传一个借贷不平的 JSON看返回是否被业务异常拦截而不是 500 报错再传一个不存在的科目 id看外键约束或业务校验是否兜得住。我见过不少项目页面操作没问题一旦绕过页面直接调接口就崩就是因为后端参数校验写得太薄。做这类管理系统我自己的习惯是「先让项目跑起来再谈改代码」。拿到一个新项目压缩包第一件事是看README或部署说明里的环境要求springboot 版本、mysql 版本、jdk 版本先对齐很多人搭环境就耗了大半天其实八成是版本不对。希望帮到你把这套流程走一遍你的 Springbootmysql 财务管理系统就能从「能跑」变成「拿得出手」。本文还有配套的精品资源点击获取