Spring Boot+Android个人财务系统：从环境配置到项目实战全解析

1. 这个项目到底能做什么：功能拆解与技术栈定位

1.1 从热搜词看大家真正关心什么

拿到这个标题，我先扫了一眼相关的网络热词。排在前面的是"springboot版本太高""java启动失败怎么解决""android进度条"这类问题，后面还跟着一大串关于 Android 文件路径的搜索记录。这说明正在找这个项目的读者，大概率不是在选型阶段，而是已经拿到源码、准备跑起来，结果被环境问题卡住了。

这其实非常真实。一个"源码+文档+运行视频+讲解视频"的毕业设计项目，它的完整价值不在于代码本身有多惊艳，而在于能不能顺利跑起来、跑起来之后能不能讲清楚每个模块的作用。这篇博文我会按照从拿到源码到最终交付的完整链路来写，重点放在那些文档里不会细说、但实际跑项目时一定会撞上的坑。

先把这个项目的核心能力讲清楚。这是一个典型的双端个人财务系统：前端是 Android 原生客户端，后端是 Spring Boot 提供的 RESTful API 服务，数据落在 MySQL 里。用户可以在手机上完成注册登录、记一笔收入或者支出、给这笔账打上分类标签（餐饮、交通、购物、工资等等）、设置月度预算、查看消费统计报表。后端负责处理这些请求，通过 Token 机制保证每个用户只能看到自己的账单数据。

这类项目的技术栈非常经典：Spring Boot 负责接口层和业务逻辑，MyBatis Plus 负责数据库操作，MySQL 存储数据，Android 端用 Retrofit 或者 OkHttp 做网络请求，用 MPAndroidChart 画统计图表，用 SharedPreferences 或者本地 SQLite 缓存登录状态。整套东西没有特别冷门的技术，但正因为"经典"，反而非常适合拿来练手和答辩讲解。

1.2 双端架构下的数据流与模块划分

想把这个项目吃透，第一步要把数据流理清楚。我习惯用一条最简单的用户操作路径来串起整个架构：用户在 Android 端输入一笔消费金额，点击保存，这时候客户端把这笔数据封装成 JSON 格式，通过 HTTP 请求发到 Spring Boot 后端；后端先校验请求头里的 Token 是否有效，然后调用 Service 层的业务方法，再通过 MyBatis Plus 的 Mapper 接口把数据写入 MySQL 数据库；写入成功后后端返回一个 JSON 响应，Android 端收到后刷新界面。

从模块划分的角度看，后端可以分成四层：

• Controller 层（接口暴露层）：接收 Android 端发来的请求，负责参数校验和响应封装。通常分为 AuthController（注册登录）、BillController（账单增删改查）、CategoryController（分类管理）、BudgetController（预算设置）、StatisticsController（统计报表）。
• Service 层（业务逻辑层）：处理具体业务规则。比如新增账单时判断是否超过当月预算、统计报表时按月份和分类聚合数据、注册时检查用户名是否重复。
• Mapper 层（数据访问层）：MyBatis Plus 的 BaseMapper 接口提供单表 CRUD 方法，复杂查询用注解或 XML 写 SQL。
• Entity 层（实体映射层）：对应数据库表结构的 Java 类，用 @TableName 和 @TableField 注解做字段映射。

Android 端的结构一般按 MVC 或者 MVP 来分包：Activity 处理界面交互，Adapter 负责列表展示，网络请求封装在一个单独的工具类或者 Retrofit Service 接口里，实体类放在 entity/model 包下。

对答辩来说，讲清楚这条数据流比讲清楚某个界面长什么样重要得多。评委最常问的问题就是"这笔账单从点击按钮到写入数据库，经过了哪些环节"，能把这条链路串下来，项目分基本就能拿住一大半。

2. 环境配置与版本匹配：拿到源码后最容易被卡住的第一关

2.1 JDK、Spring Boot 与 Android SDK 三方版本怎么对齐

先说结论：这个项目里 90% 的"java启动失败"都和版本不匹配有关。个人财务系统这种毕业设计项目，用的技术版本往往比较保守，我见过很多同学的开发环境是 JDK 17 + Spring Boot 3.x，但源码里是 JDK 1.8 + Spring Boot 2.x，一启动就报错，翻日志看到一堆 UnsupportedClassVersionError 或者 BeanCreationException。

这里我直接给出最稳的组合方案，按这个来基本不会出问题：

为什么强调 JDK 一定要和前端的 compileSdk 分开看？因为 Android 构建用的是它自己内置的 JDK（Android Studio 里可以单独设置 Gradle JDK 版本），后端的 JDK 版本和 Android 端的 JDK 版本可以不一样。很多同学以为只装一个 JDK 就够了，结果后端跑起来了，Android 构建却报 "Unsupported class file major version"，其实就是 Gradle 使用的 JDK 版本太高，把 Android Studio 的 Gradle JDK 切到同一个 JDK 8 就解决了。

2.2 常见启动失败场景的排查链路

如果你照着运行视频做还是启动不了，按下面这条链路一步步查，不要乱改代码：

第一步，看控制台报错类型。如果是UnsupportedClassFileVersionError，说明编译版本高于运行版本，检查 IDEA 右下角的 Project Structure 里 Project SDK 和 Modules SDK 是否都指向了 JDK 8。如果是Port already in use，说明 8080 被占用了，到application.properties或者application.yml里把 server.port 改成 8081、8082 都行。

第二步，看数据库连接配置。报错里出现com.mysql.cj.jdbc.exceptions.CommunicationsException或者Access denied for user，基本就是spring.datasource.url、username、password有问题。注意 MySQL 8.0 的连接 URL 要写成jdbc:mysql://localhost:3306/finance_db?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai，其中 driver-class-name 要填com.mysql.cj.jdbc.Driver；如果你用的是 MySQL 5.7，driver-class-name 则是com.mysql.jdbc.Driver。

第三步，确认数据库是否创建了。Spring Boot 启动时会尝试连接数据库，但不会自动帮你在 MySQL 里创建数据库。你需要先手动执行CREATE DATABASE finance_db DEFAULT CHARACTER SET utf8mb4;，否则报错信息会直接提示 "Unknown database"。

这里多说一句 maven 的配置。拿到源码后别急着mvn spring-boot:run，先检查本地 Maven 的 settings.xml 里有没有配置阿里云镜像。国内网络环境下，拉取 Spring Boot 依赖如果不走镜像，等十几分钟都是很正常的事。在<mirrors>节点加一个：

<mirror> <id>alimaven</id> <mirrorOf>central</mirrorOf> <url>https://maven.aliyun.com/repository/central</url> </mirror>

能省下大量等待时间。另外，源码里如果附带了 mvnw（Maven Wrapper），优先使用它来构建，能避免本机 Maven 版本和项目期望版本不一致的问题。

3. 数据库设计与 MyBatis Plus 自动建表：从表结构谈起

3.1 个人财务系统的核心数据模型

个人财务系统的表结构看起来简单，但设计时的取舍直接决定后期开发效率。一个"能跑"的项目和"讲起来有逻辑"的项目，差别就在这里。

为了把表和表之间的关系说清楚，我自己画过很多遍思路图，核心有四张表：

• user（用户表）：user_id 主键、username 唯一索引、password（存储加密后的密码）、nickname、create_time。这张表是所有业务数据的归属锚点。
• category（分类表）：category_id 主键、user_id（关联所属用户）、name、type（0 支出 / 1 收入）、icon。分类为什么用单独一张表而不是写死在客户端？因为用户在设置预算和查看报表时，需要按分类聚合统计，单独成表才能支持动态新增自定义分类。
• bill（账单表）：bill_id 主键、user_id、category_id、amount（金额）、type（0 支出 / 1 收入）、note（备注）、bill_date（账单日期）、create_time。索引建议建在 (user_id, bill_date) 上，统计报表按月、按分类查询时非常快。
• budget（预算表）：budget_id 主键、user_id、category_id（可以允许为空，表示整体预算）、budget_amount、month（预算月份，格式如 2025-07）、create_time。这里预算按月设置，一个用户一个月可以有多条分类预算。

你可能会发现，bill 表其实可以不用冗余一个 type 字段，因为通过 category_id 能关联出收支类型。但在个人财务这种小体量项目里，冗余 type 字段能省掉大量的连表查询，统计报表时哪怕不 join 分类表也能直接按 type 做聚合。多表冗余还是少表关联，是"解释成本"和"查询成本"的权衡，在答辩时把这个讲清楚，评委印象会比较好。

3.2 MyBatis Plus 根据实体类自动创建表的 SQL 逻辑

项目里大概率用到了 MyBatis Plus，很多版本还顺手带了自动建表功能。你需要搞清楚它背后的原理——这其实是 MyBatis Plus 的DbType判断加TableInfoHelper解析实体类信息，再拼接 DDL 语句的过程。如果项目里没有配置自动建表，也可以手动用create table语句建库，两者结果一致。

如果用 MyBatis Plus 的自动建表，核心逻辑是：启动时扫描带@TableName注解的实体类，读取每个类的字段注解@TableField和主键注解@TableId，生成对应的建表语句。你的实体类最好不要用int或Integer作为主键类型，推荐Long自增主键，配合@TableId(type = IdType.AUTO)，这样建表语句会自动生成auto_increment，免去后续手动设自增的麻烦。

字段命名上有个坑：Java 属性用驼峰命名（比如billDate），数据表字段用下划线命名（bill_date），MyBatis Plus 默认开启驼峰映射，所以注释和 SQL 里的字段名统一用下划线，避免后面手写 SQL 时对不上。金额字段要用DECIMAL(10,2)而不是DOUBLE，原因很简单：DOUBLE 是浮点数，算钱的时候会出现 0.1 + 0.2 = 0.30000000000000004 这种精度问题，财务数据必须用定点数。

如果你需要手动生成建表 SQL，用SHOW CREATE TABLE bill;把这个语句保存下来，放进项目的db文件夹里，README 里写清楚数据库初始化的步骤，这样别人换一台电脑测试，不用依赖自动建表也能把库建起来。这属于典型的"多一步操作但让别人省很多时间"的细节。

4. 后端接口设计与鉴权机制：让 Android 端安全地读写数据

4.1 Token 认证的完整设计

个人财务系统不能忽略权限问题——如果没有任何鉴权机制，意味着任何一个人查看你的账单接口都能把全库数据拉下来。项目里通常用 Token（登录令牌）的方式来控制访问。

完整流程是这样的：用户输入用户名密码，点击登录，Android 端把账号密码 POST 到/api/auth/login；后端校验用户名密码，通过后生成一段加密字符串（Token）并返回到客户端；客户端把这个 Token 存在本地的 SharedPreferences 里，每次发起业务请求时，在请求头里带上Authorization: token字符串；后端写一个拦截器或者 Spring Boot 的HandlerInterceptor，在请求进入 Controller 前检查 Token 是否存在、是否过期、是否对应该用户。

这个设计里有几个容易踩坑的点。第一，拦截器的放行路径要写对：注册、登录这两个接口要放行，其他接口全部拦截。如果拦截器没写好，Android 端登录成功后一请求账单列表就返回 401，排查过程很容易让人抓狂。第二，Token 过期时间的处理：Token 一般放一个有效期，比如 24 小时，超过这个时间就需要重新登录。实现的时候在 Token 里塞一个过期时间戳，每次请求校验一下当前时间即可。

第三，密码不能明文存储。这个项目虽然只是个人财务系统，但"密码加密存储"是安全常识。用BCryptPasswordEncoder或者 MD5 + 盐值做加密都可以，答辩时提一句"密码经过哈希存储，数据库被脱库也拿不到明文"是加分的。

4.2 接口返回格式与日期序列化问题

Android 端解析 JSON 时最头疼的问题就是日期格式。后端返回的LocalDateTime如果直接用默认序列化，会变成一段数组形式（[2025, 7, 15, 10, 30, 45]），Android 端用 Gson 或者 Fastjson 解析时直接报错。解决办法是在 Spring Boot 的配置里统一指定日期格式：

spring.jackson.date-format=yyyy-MM-dd HH:mm:ss spring.jackson.time-zone=GMT+8

注意时区一定要设成 GMT+8，否则你在深圳记录的账单时间会被 Jackson 按默认时区（UTC）序列化，前端看到的时间比实际时间早 8 个小时。

接口返回的统一 JSON 格式也应该固定下来。常见的封装是一个 Result 类，包含 code（状态码）、message（提示信息）、data（业务数据）：

{ "code": 200, "message": "success", "data": { "billId": 1, "amount": 39.90, "categoryName": "餐饮" } }

Android 端只需要判断code是否等于 200，再做对应处理，不需要每个接口都单独处理异常分支。这是前后端联调中最基础也是最重要的约定。

5. Android 端开发：从界面交互到数据同步的实战要点

5.1 网络请求封装与敏感数据缓存策略

Android 端开发里，最影响用户体验的就是网络请求的响应速度和进度反馈。热搜词里出现了"android进度条"，说明很多人在登录、加载账单列表中遇到过界面卡住没有任何提示的情况。

我在实战中的做法是：写一个HttpUtils工具类，封装 Retrofit + OkHttp 的核心配置，统一设置超时时间（连接超时 10 秒、读取超时 15 秒），统一添加 Token 请求头拦截器。这样每次发起请求时不必重复粘贴代码，而且以后想给所有请求加日志、加公共 header，只需要改一处。

具体来说，在 OkHttp 的拦截器里做 Token 注入：

OkHttpClient client = new OkHttpClient.Builder() .connectTimeout(10, TimeUnit.SECONDS) .readTimeout(15, TimeUnit.SECONDS) .addInterceptor(new Interceptor() { @Override public Response intercept(Chain chain) throws IOException { Request original = chain.request(); String token = SharedPreferencesUtil.getToken(); Request request = original.newBuilder() .header("Authorization", token) .method(original.method(), original.body()) .build(); return chain.proceed(request); } }) .build();

SharedPreferences 不能存敏感的用户数据，比如密码、Token 这种。实际的个人财务项目里，Token 存在 SharedPreferences 风险较大，尤其是 Android 的/data/data/package_name/shared_prefs/目录在 root 后可被直接读取。常规做法是加密后存或者存入系统保护的存储区域，这个复杂度对这个毕设项目来说略高，但至少要把"Token 不通过明文持久化"这个意识写出来，比如把 Token 加密后再存，密钥放在 JNI 层或者加密的 EncryptedSharedPreferences 里，哪怕实际用不到，答辩时说出来也会给自己加分。

5.2 账单列表、进度条与统计图表

Android 的界面部分，通常情况下项目会涉及这三个重点：

账单列表用 RecyclerView 来展示，Adapter 绑定数据和点击事件。这里要注意删除账单的交互逻辑：个人财务数据的删除是敏感操作，最好做二次确认，弹一个 AlertDialog 或者 BottomSheet 让用户确认，不要点一下就直接删。

进度条分为两种：一种是页面加载数据时显示在界面中央的转圈菊花（ProgressBar），数据到达后隐藏；另一种是预算使用情况的 HorizontalProgressBar。预算进度条很有意思，它直观地告诉用户"这个月吃饭的预算已经用了 78%"。实现时注意进度条的最大值不能直接设成 100，要设成当月预算总额，然后用已消费金额作为当前值，再做个颜色区分：剩余 30% 以下变红色，这个体验细节很加分。

统计图表一般用 MPAndroidChart。月度支出饼图返回的数据结构常见的是List<PieEntry>，每一项包含分类名和金额，后端统计接口按月返回聚合结果。这里有个细节：饼图百分比会自动计算，但要注意总额为 0 时的除零问题，后端聚合时先用条件查询过滤掉金额为 0 的分类，或者前端拿到空列表时显示"暂无数据"，而不是渲染一个空的饼图。

5.3 Android 文件路径与系统访问的适配问题

热搜词里密密麻麻的/storage/emulated/0/Android/data/...路径，说明很多人卡在了 Android 存储权限上。这里需要强调：Android 11（API 30）之后引入了分区存储机制，应用不再能随意访问Android/data目录下的其他应用文件，直接写死这些路径去读取，大概率会触发SecurityException。

个人财务系统如果要导出账本数据（比如导出 CSV 到本地），正确做法是使用MediaStore或者应用专属目录。用getExternalFilesDir(null)得到的是Android/data/你的包名/files路径，不需要额外权限，这是最简单的方式。如果需要把文件放到公共目录（比如 Download），则需要申请WRITE_EXTERNAL_STORAGE权限，而且 Android 10 以上还要配合requestLegacyExternalStorage或者在分区存储模式下走 MediaStore API。

这条虽然和核心记账功能没直接关系，但我强烈建议你把这个逻辑理顺。因为这个点的答案非常"实战"，答辩时如果被问到"文件导出怎么做的""为什么这么写"，解释清楚会有很明显的差异化效果。

6. 项目交付与二次开发：从"能跑"到"讲得清"的关键一步

6.1 运行视频、讲解视频里应该录什么

项目标题写明了带"运行视频+讲解视频"，这两个视频的内容质量基本决定了买家的使用体验。我自己帮好几个同学录过这类视频，总结出一套固定的录制结构：

运行视频：从启动 MySQL 和 Redis（如果有用到）、执行建库 SQL 脚本开始，到启动后端 Spring Boot 项目，再到打开 Android 模拟器或真机运行 APP。全程录屏，关键操作放慢速度，比如数据库密码输入、项目启动等待过程，这些地方新手最容易被绕晕。

讲解视频：按模块讲，先讲后端（登录注册接口、账单 CRUD、预算逻辑、统计接口），再讲 Android 端（页面结构、网络层、数据绑定），最后串一条完整链路演示。讲解时不要照着源码念，要把"为什么这么设计"讲出来——为什么账单和分类要分开两张表？为什么用了 MyBatis Plus？为什么 Token 要放在请求头？这些是答辩时评委真正会问的东西。

6.2 代码打包、文档完善与答辩前的自测清单

如果你想把项目作为毕业设计提交，或者打算自己跑通后二次开发，这几件事一定要在交付前做完：

项目文档要补齐的内容：

• 环境要求（JDK 版本、MySQL 版本、Android Studio 版本）
• 快速启动步骤（数据库初始化、后端启动、Android 端构建运行）
• 核心接口说明表格（请求方式、路径、参数、返回示例）
• 数据库表结构说明（每张表的字段含义）
• 常见问题 FAQ（密码错误、端口被占用、依赖下载失败）

答辩前的自测清单：

• 数据库从零初始化能否跑起来？找一台没装过 MySQL 的电脑试试。
• 后端离线启动会不会卡在自动建表？确认建表 SQL 脚本存在且可重复执行。
• Android 端在模拟器和真机上分别测一次，确认模拟器网络地址（10.0.2.2 访问本机后端）和真机（用局域网 IP）的差异。
• Token 过期后重新登录是否正常？
• 同一账号在不同设备登录会不会互相顶掉？如果项目没有做单点登录，这个可以留在文档里作为"已知不足"。

这里再提醒一句：换一台电脑跑不起来的项目，根本原因九成出在环境上。所以交付时把环境依赖说清楚，比任何代码优化都重要。我自己习惯的做法是把 JDK 8 的安装包路径、MySQL 的初始化脚本、Maven 镜像配置全都写进一个环境准备.md，新电脑照着做，十五分钟就能跑起来，这比讲解视频更省事。

6.3 个人财务系统进阶方向：如何在这个基础上多走一步

项目交付不等于终点。很多拿到这套源码的人，其实有更多需求——或者想把这个项目作为跳板，做出更有竞争力的作品。

几个性价比很高的扩展方向：

• 加入图表对比功能：月度支出和收入趋势折线图，以及环比、同比数据。SQL 上用DATE_FORMAT(bill_date, '%Y-%m')分组再聚合即可，Android 端加一个折线图页面。
• 加入定时提醒：比如每月可以生成一次月度账单总结消息——不过这不涉及短信通知，只保留"待办提醒"或本地通知即可，用 WorkManager 配合 Android 系统通知就能实现。
• 加入多端数据同步：把 Android 端的数据改为优先读取本地 SQLite 缓存，网络不好时先记账，联网后再和后端同步。这个功能很接地气，实现起来也不难，数据库层面加一个 sync_status 字段就行。
• 引入报表导出：用 POI 或 EasyExcel 生成 Excel 报表文件，后端提供一个/api/export/excel接口，Android 端点击按钮下载并打开。个人觉得这个功能最实用，也最能体现工程能力。

这些扩展方向都跑不掉最基础的 "永远保持后端接口的兼容性" 这一条：新增接口时不要改掉旧的返回格式，否则老版本 Android 端会直接崩溃。越是小的项目，接口协议的稳定性越重要。

写在最后：跑通之后，记得把"为什么"也讲清楚

这套 Java Spring Boot + Android 的个人财务系统，从技术难度上看不算高，但它是典型"麻雀虽小、五脏俱全"的项目。你在跑通它之后，我强烈建议花一个下午做一件事：给项目的核心代码加上你自己的注释，比如// 校验 Token 是否过期，过期则返回 401 让客户端重新登录、// 聚合当前月份每个分类的总支出，返回给图表。加注释的过程就是你理解代码的过程，答辩时你不需要背源码，而是讲出"这句代码为什么这么写"就够了。

我遇到过不少同学，拿到源码当天就能跑起来，但是被评委追问两句就问懵了。靠的是背稿子。真正稳妥的方式，是把数据流、表关系、Token 机制、日期序列化这四件事用自己的话讲一遍，讲得顺了，这个项目才真正变成你自己的。

最后再分享一个小技巧：如果你用的是 IntelliJ IDEA，跑后端项目之前先按Ctrl+Alt+S打开 Settings，把 Maven 的自动导入打开，再把File -> Project Structure里的 Project SDK 确认成 JDK 1.8。我之前愣是卡在这里近一个小时，检查了无数次代码，最后发现只是这边没对齐。别问我为什么知道这么多"坑"，问就是都踩过。