当前位置：首页 > news >正文

基于SpringBoot的社区养老服务管理系统开发实践：效率提升与架构优化指南

news 2026/5/12 15:02:21

如果你也曾在毕业设计里被“重复写 CRUD、事务到处 try-catch、上线后接口慢得想砸键盘”支配过，这篇笔记把踩过的坑一次性打包给你。源码编号 58326，关键词只有两个字：效率。

1. 典型开发痛点：时间都去哪儿了

拿到社区养老需求清单时，我第一反应是“不就是个增删改查吗？”——结果三周过去，还在给Service层补事务。

CRUD 冗余：老人信息、员工信息、服务记录三张表，每张表都要写insert、update、pageList，复制粘贴到怀疑人生。
事务管理混乱：预约服务要同时扣减“可用次数”并写入“服务记录”，忘记加@Transactional导致数据对不上，排查花掉一下午。
接口慢：联调时前端同学把“查询老人列表”点成了 DDoS，一次请求 3 s 返回，数据库 CPU 飙红。
部署效率低：本地 jar 包 120 MB，服务器 1 核 2 G，上传 10 分钟，启动再花 3 分钟，调一行代码成本巨大。

2. 技术选型对比：让每一行代码都有理有据

2.1 ORM 选型：MyBatis-Plus vs Spring Data JPA

维度	MyBatis-Plus	JPA
学习曲线	低，会 SQL 就能写	高，要懂持久化状态
复杂 SQL	自由拼 SQL，一眼看到执行计划	写`@Query`也能跑，但调试要开`show-sql`
代码量	内置通用 Mapper，单表 0 SQL	单表也能 0 SQL，但多表 join 容易 N+1
性能可控性	直写 SQL，索引一目了然	容易被懒加载坑，加`fetch`后 SQL 爆炸

结论：养老系统报表多、字段多、统计 SQL 复杂，选 MyBatis-Plus；如果未来想快速换 MongoDB 再考虑 JPA。

2.2 缓存必要性论证

读场景：老人档案、服务类型、员工排班，90% 读 10% 写。
并发：社区中心高峰期 50 QPS，数据库扛得住，但前端要求 <300 ms。
成本：Redis 4.0 单实例 50 MB 内存足够，命中率 95%，平均 RT 从 450 ms 降到 40 ms。

一句话：缓存不是“高并发”才用，而是“性价比”最高的优化。

3. 核心模块实现：Clean Code 版代码直接抄

3.1 老人信息管理

需求：支持分页、多条件模糊查询、头像上传、数据脱敏。

分层
controller → service → mapper → entity → dto/vo
每层只干一件事：controller 参数校验、service 组合业务、mapper 数据访问。

代码片段

@RestController @RequestMapping("/elder") public class ElderController { @Resource private ElderService elderService; @GetMapping("/page") public PageResult<EderVO> page(@Valid ElderPageDTO dto){ // 关键：DTO 直接转 MP 的 QueryWrapper，不写 if-else return elderService.pageElder(dto); } } @Service public class ElderServiceImpl implements ElderService{ @Resource private ElderMapper elderMapper; @Cacheable(value = "elder", key = "#dto.toString()") public PageResult<EderVO> pageElder(ElderPageDTO dto){ LambdaQueryWrapper<Elder> wrapper = Wrappers.lambdaQuery(); wrapper.like(StringUtils.isNotBlank(dto.getName()), Elder::getName, dto.getName()) .eq(dto.getGender()!=null, Elder::getGender, dto.getGender()) .orderByDesc(Elder::getCreateTime); Page<Elder> page = elderMapper.selectPage( new Page<>(dto.getPageNum(), dto.getPageSize()), wrapper); // 自动脱敏：手机号中间四位星号 List<EderVO> voList = page.getRecords().stream() .map(e -> ElderConvert.toVo(e, true)) .collect(Collectors.toList()); return PageResult.of(voList, page.getTotal()); } }

要点：

DTO 复用 MP 分页对象，省去PageParam自定义类。
缓存 key 用 DTO 的 toString，保证同参数命中；参数变，key 变，无脏数据。
脱敏逻辑放convert，不在entity里写getDesensitizedPhone()，保持实体干净。

3.2 服务预约流程

业务规则：

一个老人同一时段只能预约一个服务。
预约成功扣减“可用次数”，取消时回滚。

时序
前端提交 → 校验时段冲突 → 锁定行（悲观锁）→ 扣次 → 写预约记录 → 释放锁。

事务与锁

@Transactional(rollbackFor = Exception.class) public Long makeAppointment(AppointmentDTO dto){ // 1. 校验时段冲突 boolean conflict = appointmentMapper.existConflict(dto.getElderId(), dto.getServiceStartTime(), dto.getServiceEndTime()); if(conflict) throw new BizException("时段冲突"); // 2. 悲观锁锁住 elder_account 行，防止并发超扣 ElderAccount account = elderAccountMapper.selectForUpdate(dto.getElderId()); if(account.getAvailableCount() <= 0) throw new BizException("次数不足"); // 3. 扣次 int rows = elderAccountMapper.decreaseCount(dto.getElderId(), 1); if(rows == 0) throw new BizException("扣次失败"); // 4. 写记录 Appointment record = AppointmentConvert.toEntity(dto); appointmentMapper.insert(record); return record.getId(); }

关键注释：

selectForUpdate只在需要时开事务，缩小锁粒度。
decreaseCount使用where available_count > 0保证安全，防止 0 变负。
事务边界放在service方法，controller 只做入参转换。

4. 性能 & 安全：快的同时别给攻击者留门

4.1 接口幂等性

场景：前端点击“预约”两次，生成了两条记录。

方案：在appointment表建联合唯一索引(elder_id, service_start_time)，第二次插入抛DuplicateKeyException，捕获后返回“已预约”提示，即可天然幂等。

4.2 SQL 注入防护

MyBatis-Plus 条件构造器底层使用预编译，只要不用${}拼接，就无注入风险。
额外加一层：启动阶段打开mybatis-plus.global-config.sql-parser=true，非法 SQL 直接拒绝执行。

4.3 敏感数据加密

老人身份证、病历属于个人信息。入库前用AES-128/CBC/PKCS5Padding加密，密钥放 Jasypt 统一管理，启动参数注入：

java -jar elder-app.jar --jasypt.encryptor.password=YourStrongPassword

查询时自动解密，对业务代码透明。

5. 生产环境避坑清单

静态资源路径
SpringBoot 默认把/static/**映射到classpath:/static/。打成 jar 后，上传头像会报“无法创建目录”。
解决：在application-prod.yml里把文件目录外置
```
file: upload-dir: /data/elder/upload spring: mvc: static-path-pattern: /upload/**
```
然后 Nginx 直接指到/data/elder/upload，不走应用，减少 IO。
数据库连接池
服务器 1C2G，MySQL 5.7，默认 HikariCP 配置：
```
spring: datasource: hikari: maximum-pool-size: 8 minimum-idle: 4 idle-timeout: 30000 connection-test-query: SELECT 1
```
经验值：CPU 核心 * 2 + 1，小内存机器再减一半，防止连接打满把内存吃光。
日志异步 & 归档
默认logback-spring.xml同步写文件，高并发时线程阻塞。加AsyncAppender并把maxHistory设为 15 天，磁盘只保留最近 3 GB，避免日志把磁盘打爆。
启动加速
- 关闭不需要的自动配置：@EnableAutoConfiguration(exclude={DataSourceAutoConfiguration.class})
- 用spring-context-indexer预建组件索引，启动时间从 8 s 降到 5 s。