1. 项目概述：防疫物资捐赠系统设计与实现
这个基于SpringBoot的防疫物资捐赠系统是我去年指导计算机专业学生完成的毕业设计项目，整个系统从需求分析到部署上线耗时3个月。系统主要解决突发公共卫生事件中物资调配不透明、捐赠渠道不畅的问题，实现了捐赠方、受赠方和管理员三方的在线协同。系统采用B/S架构，前端使用Thymeleaf模板引擎，后端基于SpringBoot 2.7.3开发，数据库选用MySQL 8.0，是一个典型的Java Web全栈项目。
提示：毕业设计类项目需要特别注意文档完整性和代码规范性，这是答辩评分的重要依据
系统最核心的创新点在于引入了区块链存证技术（使用Hyperledger Fabric的简化集成方案），所有物资流转记录都会生成哈希值上链，确保捐赠过程可追溯。这个设计点后来成为该生论文的亮点章节，也是答辩时评委特别关注的部分。整套系统包含12个功能模块，从用户注册到物资追踪形成完整闭环。
2. 系统架构与技术选型
2.1 整体架构设计
系统采用经典的三层架构：
- 表现层：Thymeleaf + Bootstrap 5
- 业务层：SpringBoot + Spring Security
- 数据层：MySQL + Redis（缓存）
mermaid复制[严禁使用mermaid图表]
实际开发中我们做了几个关键调整：
- 用Hutool工具包替代了部分Apache Commons组件，显著减少了依赖冲突
- 采用MyBatis-Plus而非原生MyBatis，开发效率提升约40%
- 引入Elasticsearch实现捐赠物资的模糊搜索
2.2 核心技术组件版本
| 组件 | 版本 | 选型理由 |
|---|---|---|
| SpringBoot | 2.7.3 | LTS版本，社区支持完善 |
| MySQL | 8.0.28 | 支持JSON字段和窗口函数 |
| Redis | 6.2.6 | 满足高并发场景需求 |
| JDK | 11 | 兼顾新特性和稳定性 |
| PageHelper | 5.3.2 | 分页插件中最稳定的选择 |
注意：MySQL 8.x默认使用caching_sha2_password认证，旧版客户端连接时需要特别配置
3. 核心功能实现细节
3.1 物资捐赠流程实现
捐赠流程的状态机设计是关键难点，我们采用Spring StateMachine框架实现：
java复制// 捐赠状态枚举
public enum DonationStates {
INIT, VERIFYING, APPROVED,
REJECTED, DISTRIBUTING, COMPLETED
}
// 状态转换配置
@Configuration
@EnableStateMachine
public class DonationStateMachineConfig
extends EnumStateMachineConfigurerAdapter<DonationStates, DonationEvents> {
@Override
public void configure(StateMachineStateConfigurer<DonationStates, DonationEvents> states)
throws Exception {
states.withStates()
.initial(DonationStates.INIT)
.states(EnumSet.allOf(DonationStates.class));
}
@Override
public void configure(StateMachineTransitionConfigurer<DonationStates, DonationEvents> transitions)
throws Exception {
transitions
.withExternal()
.source(DonationStates.INIT)
.target(DonationStates.VERIFYING)
.event(DonationEvents.SUBMIT)
// 其他转换规则...
}
}
3.2 区块链存证实现
我们简化了Hyperledger Fabric的集成方案，核心是使用Fabric Java SDK的ChaincodeInvoker：
java复制public class BlockchainService {
private static final String CHANNEL_NAME = "donationchannel";
private static final String CHAINCODE_NAME = "donationcc";
public String recordToChain(DonationRecord record) throws Exception {
Map<String, byte[]> transMap = new HashMap<>();
transMap.put("donor", record.getDonor().getBytes());
transMap.put("items", JsonUtil.toJson(record.getItems()).getBytes());
TransactionProposalRequest request = fabricClient.newTransactionProposalRequest();
request.setChaincodeID(CHAINCODE_NAME);
request.setFcn("createRecord");
request.setTransientMap(transMap);
Collection<ProposalResponse> responses =
fabricClient.sendTransactionProposal(request);
// 处理响应并提交交易...
return transactionID;
}
}
4. 数据库设计要点
4.1 核心表结构
物资表设计特别注意字段冗余：
sql复制CREATE TABLE `donation_item` (
`id` bigint NOT NULL AUTO_INCREMENT,
`name` varchar(100) NOT NULL COMMENT '物资名称',
`category_id` int NOT NULL COMMENT '分类ID',
`category_name` varchar(50) NOT NULL COMMENT '分类名称（冗余）',
`specification` json DEFAULT NULL COMMENT '规格参数',
`unit` varchar(20) NOT NULL COMMENT '计量单位',
`quantity` decimal(12,3) NOT NULL COMMENT '数量',
`quality_period` int DEFAULT NULL COMMENT '保质期(天)',
`storage_condition` varchar(100) DEFAULT NULL COMMENT '存储条件',
PRIMARY KEY (`id`),
KEY `idx_category` (`category_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
经验：高频查询字段适当冗余可以避免多表关联，json字段适合存储非结构化规格参数
4.2 查询优化实践
物资分页查询的典型优化方案：
java复制public PageInfo<DonationItem> queryItems(ItemQuery query, int pageNum, int pageSize) {
PageHelper.startPage(pageNum, pageSize);
// 使用LambdaQueryWrapper避免SQL注入
LambdaQueryWrapper<DonationItem> wrapper = Wrappers.lambdaQuery();
wrapper.eq(query.getCategoryId() != null,
DonationItem::getCategoryId, query.getCategoryId())
.like(StringUtils.isNotBlank(query.getKeyword()),
DonationItem::getName, query.getKeyword())
.orderByDesc(DonationItem::getId);
List<DonationItem> items = donationItemMapper.selectList(wrapper);
return new PageInfo<>(items);
}
5. 开发环境搭建指南
5.1 标准环境配置
推荐使用Docker Compose快速搭建开发环境：
yaml复制version: '3'
services:
mysql:
image: mysql:8.0.28
environment:
MYSQL_ROOT_PASSWORD: root123
MYSQL_DATABASE: donation_db
ports:
- "3306:3306"
volumes:
- ./mysql/data:/var/lib/mysql
- ./mysql/conf:/etc/mysql/conf.d
redis:
image: redis:6.2.6-alpine
ports:
- "6379:6379"
volumes:
- ./redis/data:/data
5.2 常见环境问题解决
问题1：MySQL 8.x连接失败
解决方案：在连接字符串添加参数：
code复制jdbc:mysql://localhost:3306/donation_db?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=Asia/Shanghai
问题2：Redis序列化异常
需要在Spring配置中添加：
java复制@Bean
public RedisTemplate<String, Object> redisTemplate() {
RedisTemplate<String, Object> template = new RedisTemplate<>();
template.setKeySerializer(new StringRedisSerializer());
template.setValueSerializer(new GenericJackson2JsonRedisSerializer());
// 其他配置...
return template;
}
6. 毕业设计特别注意事项
6.1 论文写作要点
- 技术选型依据：要详细对比SpringBoot与传统SSM框架的优劣
- 系统测试章节：必须包含压力测试数据（建议使用JMeter）
- 创新点描述：突出区块链存证的设计思路和实现方案
6.2 答辩准备建议
- 准备3分钟的系统演示视频备用
- 重点掌握状态机和区块链的实现原理
- 打印关键代码片段（不超过20行）作为答辩材料
7. 项目部署实战
7.1 生产环境部署
推荐使用Jenkins + Docker实现CI/CD：
bash复制# 构建Docker镜像
mvn clean package
docker build -t donation-system:v1.0 .
# 运行容器
docker run -d -p 8080:8080 \
-e SPRING_DATASOURCE_URL=jdbc:mysql://mysql-host:3306/donation_db \
--name donation-app \
donation-system:v1.0
7.2 性能调优参数
在application-prod.yml中配置：
yaml复制server:
tomcat:
max-threads: 200
min-spare-threads: 20
spring:
datasource:
hikari:
maximum-pool-size: 30
connection-timeout: 30000
redis:
lettuce:
pool:
max-active: 50
max-wait: 10000
8. 扩展开发建议
- 微信小程序端：可基于uniapp开发捐赠者小程序
- 数据大屏：使用ECharts实现物资流向可视化
- 智能合约升级：增加自动匹配捐赠需求的功能
这个项目在实际开发过程中最大的教训是过早优化——我们最初花了太多时间设计完美的权限系统，后来发现基于Spring Security的默认实现已经能满足90%的需求。建议学弟学妹们先实现核心业务流，再逐步完善周边功能。