1. 项目背景与核心价值
家庭财务管理是每个现代家庭都面临的刚需。随着移动互联网的普及，传统的手工记账方式已经无法满足人们对财务数据实时性、可视化分析的需求。作为一名长期关注Java Web技术栈的开发者，我发现市场上虽然有不少财务管理App，但大多存在以下痛点：
- 数据隐私性存疑（云端存储的财务信息存在泄露风险）
- 功能过于复杂（附带大量与核心记账无关的社交、广告模块）
- 定制化程度低（无法根据家庭特殊需求调整分类和报表）
这正是我选择开发本地化部署的Java Web家庭财务管理系统的原因。基于Spring Boot + Vue.js的技术组合，系统实现了以下核心价值：
- 全链路数据自主掌控：所有数据存储在家庭本地MySQL数据库中，杜绝第三方云服务的数据泄露风险
- 轻量级架构设计：采用微服务架构但保持极简依赖（仅需JDK+MySQL环境），老电脑也能流畅运行
- 智能分类引擎：通过关键词识别+手动修正的双重机制，自动将消费记录归入预设类别（如"食品""教育"等）
提示：系统特别设计了"家庭共享账本"功能，支持多成员通过不同权限角色（管理员/普通成员）协同维护同一套财务数据。
2. 技术架构解析
2.1 整体技术栈选型
经过对三个候选方案的对比测试（传统SSM架构、Spring Boot单体应用、Spring Cloud微服务），最终技术栈确定如下：
| 层级 | 技术选型 | 选择理由 |
|---|---|---|
| 前端 | Vue 3 + Element Plus | 组件丰富度高，与后端Spring Boot的RestAPI对接调试简便 |
| 后端框架 | Spring Boot 2.7.18 | 内嵌Tomcat简化部署，starter依赖机制大幅减少配置工作量 |
| 安全认证 | Spring Security + JWT | 实现基于角色的动态权限控制（RBAC），JWT令牌支持移动端无状态认证 |
| 数据持久化 | MyBatis-Plus 3.5.3.1 | 内置通用Mapper减少70%的CRUD代码量，支持Lambda表达式编写类型安全的查询条件 |
| 图表渲染 | ECharts 5.4.3 | 提供符合国人习惯的财务趋势图、占比饼图等20+种可视化组件 |
| 开发工具链 | Lombok + MapStruct | 自动生成getter/setter和DTO转换代码，提升开发效率 |
2.2 核心业务表设计
财务系统的数据模型设计遵循"高内聚低耦合"原则，主要包含以下核心表：
sql复制-- 用户主表
CREATE TABLE `user` (
`id` BIGINT PRIMARY KEY AUTO_INCREMENT,
`username` VARCHAR(32) NOT NULL COMMENT '登录账号',
`password` VARCHAR(64) NOT NULL COMMENT 'BCrypt加密密码',
`family_id` BIGINT COMMENT '所属家庭ID',
`role` ENUM('ADMIN','MEMBER') DEFAULT 'MEMBER'
);
-- 家庭账本表
CREATE TABLE `family` (
`id` BIGINT PRIMARY KEY AUTO_INCREMENT,
`name` VARCHAR(64) NOT NULL COMMENT '家庭名称',
`create_time` DATETIME DEFAULT CURRENT_TIMESTAMP
);
-- 财务记录表（核心业务表）
CREATE TABLE `financial_record` (
`id` BIGINT PRIMARY KEY AUTO_INCREMENT,
`family_id` BIGINT NOT NULL,
`user_id` BIGINT NOT NULL,
`amount` DECIMAL(12,2) NOT NULL COMMENT '金额（正数为收入，负数为支出）',
`category_id` INT NOT NULL COMMENT '关联category表',
`transaction_time` DATETIME NOT NULL COMMENT '交易时间',
`remark` VARCHAR(255) COMMENT '备注信息',
`attachment_url` VARCHAR(512) COMMENT '凭证图片URL'
);
-- 分类维度表
CREATE TABLE `category` (
`id` INT PRIMARY KEY AUTO_INCREMENT,
`name` VARCHAR(32) NOT NULL,
`type` ENUM('INCOME','EXPENSE') NOT NULL COMMENT '收入/支出类型',
`icon` VARCHAR(64) COMMENT 'FontAwesome图标类名'
);
注意：金额字段使用DECIMAL而非FLOAT，避免浮点数计算精度问题。所有表字段均采用下划线命名法并与实体类属性严格对应。
3. 关键功能实现细节
3.1 智能分类引擎实现
系统通过"规则引擎+用户反馈"的双层机制实现消费记录的自动分类：
-
关键词规则库：预置常见消费场景的关键词映射
java复制// 示例规则配置类 @Component public class CategoryRules { private static final Map<String, Integer> KEYWORD_TO_CATEGORY = Map.of( "奶茶", 101, // 101=餐饮 "星巴克", 101, "学费", 201, // 201=教育 "教材", 201 ); public Integer matchCategory(String remark) { return KEYWORD_TO_CATEGORY.entrySet().stream() .filter(e -> remark.contains(e.getKey())) .findFirst() .map(Map.Entry::getValue) .orElse(null); } } -
用户修正学习：当自动分类错误时，用户手动调整后系统会记录此次修正，逐步完善规则库
java复制@Transactional public void correctCategory(Long recordId, Integer newCategoryId) { FinancialRecord record = recordMapper.selectById(recordId); // 将修正对保存到学习表 learnMapper.insert(new CategoryLearn( record.getRemark(), record.getCategoryId(), newCategoryId )); // 更新原记录 record.setCategoryId(newCategoryId); recordMapper.updateById(record); }
3.2 多维度财务统计
基于MyBatis-Plus的Wrapper条件构造器，实现灵活的统计查询：
java复制public List<FinancialStatVO> getStats(Long familyId, LocalDate start, LocalDate end) {
// 构造查询条件
QueryWrapper<FinancialRecord> wrapper = new QueryWrapper<FinancialRecord>()
.select("category_id", "SUM(amount) AS total")
.eq("family_id", familyId)
.between("transaction_time", start, end)
.groupBy("category_id");
// 执行查询并关联分类信息
return recordMapper.selectMaps(wrapper).stream()
.map(map -> {
Integer categoryId = (Integer) map.get("category_id");
Category category = categoryMapper.selectById(categoryId);
return new FinancialStatVO(
category.getName(),
(BigDecimal) map.get("total"),
category.getType()
);
})
.collect(Collectors.toList());
}
前端通过ECharts的dataset特性动态渲染统计结果：
javascript复制// Vue组件中配置图表
const option = {
dataset: {
source: statsData // 后端返回的统计结果
},
series: [{
type: 'pie',
encode: {
value: 'total',
itemName: 'categoryName'
}
}]
};
4. 部署与运维实践
4.1 本地化部署方案
系统支持两种部署模式：
-
开发模式（适合毕设演示）：
bash复制# 前端 cd frontend && npm run serve # 后端 mvn spring-boot:run -Dspring.profiles.active=dev -
生产模式（家庭实际使用）：
bash复制# 打包前端 npm run build # 打包后端（生成可执行jar） mvn package -Pprod # 启动服务 java -jar family-finance.jar --server.port=8080
关键配置项（application-prod.yml）：
yaml复制spring: datasource: url: jdbc:mysql://localhost:3306/family_finance?useSSL=false username: homeuser password: ${DB_PASSWORD} # 从环境变量读取 servlet: multipart: max-file-size: 10MB # 凭证图片大小限制
4.2 数据备份策略
为防止硬件故障导致数据丢失，建议配置自动化备份方案：
-
MySQL定时导出（通过crontab）：
bash复制# 每天3点执行全量备份 0 3 * * * mysqldump -u root -p[password] family_finance > /backups/finance_$(date +\%Y\%m\%d).sql -
重要操作日志审计：
java复制@Aspect @Component public class OperationLogAspect { @AfterReturning("@annotation(com.xxx.annotation.OperateLog)") public void logOperation(JoinPoint jp) { String operation = ((MethodSignature)jp.getSignature()).getMethod() .getAnnotation(OperateLog.class).value(); logService.save(new OperationLog( SecurityUtils.getCurrentUserId(), operation, new Date() )); } }
5. 毕设开发经验分享
在完成该系统的过程中，我总结了以下值得注意的经验：
-
金额计算的精度陷阱
- 错误做法：使用
double类型进行金额计算会导致精度丢失 - 正确方案：始终使用
BigDecimal并指定运算精度
java复制// 错误示例：0.1 + 0.2 = 0.30000000000000004 double d = 0.1 + 0.2; // 正确做法 BigDecimal total = new BigDecimal("0.1") .add(new BigDecimal("0.2")) .setScale(2, RoundingMode.HALF_UP); - 错误做法：使用
-
事务处理的边界控制
- 在Service层方法添加
@Transactional时，务必考虑：- 是否需要读写隔离级别（默认READ_COMMITTED是否足够）
- 方法执行时间是否可能超过数据库连接等待超时时间
- 异常类型是否需要回滚（通过
rollbackFor指定）
- 在Service层方法添加
-
前端性能优化技巧
- 对大数据量报表采用分页加载+虚拟滚动技术
- 使用Web Worker处理复杂的本地计算（如年度报表生成）
- 对ECharts图表配置
dataZoom实现千万级数据的平滑缩放
-
安全防护要点
- 密码必须使用BCrypt加密（Spring Security默认提供）
- 所有API接口添加CSRF Token防护
- 文件上传限制后缀名并重命名存储（防止脚本注入）
这个项目从技术选型到最终部署，完整实践了Java Web应用的开发全流程。特别是在家庭协同记账的场景下，如何平衡数据一致性与操作便捷性，是设计过程中最值得深入思考的架构问题。