Spring Boot个人记账系统开发实战

1. 项目概述

这个基于Spring Boot的个人记账系统是一个面向个人用户的财务管理解决方案。作为一名长期从事Java开发的工程师，我发现很多朋友都在为个人财务管理的混乱而苦恼。市面上的记账软件要么功能过于复杂，要么存在隐私风险，于是萌生了开发一个轻量级、可自定义的个人记账系统的想法。

系统采用Spring Boot作为基础框架，结合MyBatis-Plus进行数据持久化操作，前端使用Thymeleaf模板引擎渲染页面。整个系统从需求分析到部署上线历时3个月，期间经历了多次架构调整和功能迭代，最终形成了一个稳定可用的版本。

提示：这个项目非常适合作为计算机相关专业的毕业设计选题，因为它涵盖了企业级应用开发的核心技术栈，同时业务逻辑清晰易懂，不会让评审老师觉得过于简单或复杂。

2. 系统设计与架构解析

2.1 技术选型考量

选择Spring Boot作为基础框架主要基于以下几点考虑：

1. 快速开发：Spring Boot的自动配置和起步依赖可以大幅减少样板代码
2. 生态丰富：Spring生态有大量成熟的解决方案可供选择
3. 易于扩展：当需要添加新功能时，可以平滑集成其他Spring组件
4. 社区支持：遇到问题可以快速找到解决方案

数据库选用MySQL 8.0，主要考虑到：

• 事务支持完善
• 开源免费
• 性能足够应对个人使用场景
• 与Spring Boot集成简单

前端选择Thymeleaf而非前后端分离架构，主要是为了：

1. 降低学习成本（不需要额外学习Vue/React）
2. 减少部署复杂度
3. 更适合小型单体应用

2.2 系统架构设计

系统采用经典的三层架构：

1. 表现层：Thymeleaf模板 + Bootstrap前端框架
2. 业务逻辑层：Spring MVC控制器 + 服务层
3. 数据访问层：MyBatis-Plus + MySQL

这种分层设计使得各层职责清晰，便于维护和扩展。例如当需要更换数据库时，只需修改数据访问层的实现，不会影响其他层。

3. 核心功能实现细节

3.1 用户认证模块

采用Spring Security实现用户认证和授权功能。考虑到个人记账系统的特点，我们实现了以下安全特性：

1. 密码加密存储：使用BCryptPasswordEncoder对用户密码进行加密
2. CSRF防护：默认启用Spring Security的CSRF保护
3. 会话管理：配置合理的会话超时时间（30分钟）
4. 登录失败限制：连续5次失败后锁定账户10分钟

java复制@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {
    
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.authorizeRequests()
            .antMatchers("/static/**").permitAll()
            .antMatchers("/register").permitAll()
            .anyRequest().authenticated()
            .and()
            .formLogin()
            .loginPage("/login")
            .defaultSuccessUrl("/dashboard")
            .permitAll()
            .and()
            .logout()
            .logoutSuccessUrl("/login?logout")
            .permitAll();
    }
    
    @Bean
    public PasswordEncoder passwordEncoder() {
        return new BCryptPasswordEncoder();
    }
}

3.2 收支记录管理

这是系统的核心功能模块，主要包含以下特性：

1. 多条件查询：支持按日期范围、收支类型、金额区间等条件组合查询
2. 分类统计：自动按类别统计收支情况
3. 数据导出：支持将记录导出为Excel文件
4. 批量操作：支持批量删除、批量修改分类等操作

数据库表设计如下：

sql复制CREATE TABLE `financial_record` (
  `id` bigint NOT NULL AUTO_INCREMENT,
  `user_id` bigint NOT NULL,
  `type` tinyint NOT NULL COMMENT '1-收入 2-支出',
  `amount` decimal(10,2) NOT NULL,
  `category_id` int NOT NULL,
  `remark` varchar(255) DEFAULT NULL,
  `record_date` date NOT NULL,
  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  KEY `idx_user_date` (`user_id`,`record_date`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

3.3 数据可视化

使用ECharts实现收支数据的可视化展示，主要包括：

1. 月度收支趋势图
2. 支出类别饼图
3. 收入来源分布图
4. 年度对比柱状图

前端通过Ajax请求获取后端提供的JSON数据，然后使用ECharts进行渲染：

javascript复制function loadCategoryPieChart() {
    $.get('/api/statistics/category', function(data) {
        var chart = echarts.init(document.getElementById('category-chart'));
        var option = {
            title: { text: '支出类别分布' },
            tooltip: { trigger: 'item' },
            series: [{
                name: '支出类别',
                type: 'pie',
                radius: '50%',
                data: data,
                emphasis: { itemStyle: { shadowBlur: 10 } }
            }]
        };
        chart.setOption(option);
    });
}

4. 系统部署与运维

4.1 环境准备

系统运行需要以下环境：

• JDK 1.8+
• MySQL 8.0+
• Maven 3.6+

推荐使用Docker进行部署，可以避免环境配置问题。我们提供了docker-compose.yml文件，一键启动所有服务：

yaml复制version: '3'
services:
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: finance
    ports:
      - "3306:3306"
    volumes:
      - mysql_data:/var/lib/mysql
  app:
    build: .
    ports:
      - "8080:8080"
    depends_on:
      - mysql
    environment:
      SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/finance
volumes:
  mysql_data:

4.2 性能优化

针对个人记账系统的特点，我们做了以下性能优化：

1. 数据库索引优化：为常用查询字段添加复合索引
2. 缓存策略：对静态数据和频繁访问的统计结果进行缓存
3. 批量操作：支持记录的批量导入导出
4. 懒加载：大数据量列表采用分页加载

5. 开发经验与问题解决

5.1 开发中的关键决策

1. 选择MyBatis-Plus而非JPA：考虑到团队更熟悉MyBatis，且需要更灵活的SQL控制
2. 放弃前后端分离：项目规模较小，单体架构更合适
3. 使用Thymeleaf而非JSP：Thymeleaf模板更现代，与Spring Boot集成更好

5.2 遇到的典型问题及解决方案

问题1：日期查询性能差

初期实现使用MySQL的DATE_FORMAT函数对记录日期进行格式化后比较，导致无法使用索引。优化后改为直接使用日期范围查询：

sql复制-- 优化前（性能差）
SELECT * FROM financial_record 
WHERE DATE_FORMAT(record_date, '%Y-%m') = '2023-01'

-- 优化后（性能好）
SELECT * FROM financial_record 
WHERE record_date BETWEEN '2023-01-01' AND '2023-01-31'

问题2：并发修改冲突

多个浏览器标签同时修改同一条记录时可能产生冲突。解决方案：

1. 添加版本号字段实现乐观锁
2. 在编辑页面显示最后修改时间和修改人
3. 提交时校验数据是否已被修改

java复制@TableField(fill = FieldFill.INSERT_UPDATE)
private LocalDateTime updateTime;

@Version
private Integer version;

6. 项目扩展方向

这个基础版本完成后，还可以考虑以下扩展方向：

1. 多设备同步：开发移动端APP，实现数据云端同步
2. 预算管理：设置各类别预算，超支提醒
3. 账单提醒：定期账单到期提醒功能
4. 数据备份：自动备份到网盘或邮箱
5. 多币种支持：出国旅行或海淘场景下的多币种记账

实际开发中，我发现最大的挑战不是技术实现，而是如何设计出符合用户直觉的操作流程。经过多次用户测试和调整，最终形成了一个既功能完整又易于使用的界面设计。