1. 项目背景与核心价值
校园周边美食探索与分享平台是一个典型的Web应用项目，特别适合作为计算机相关专业的毕业设计选题。这个项目源于一个真实的用户痛点：每年新生入学时，面对校园周边密集的餐饮店铺往往无从选择，而高年级学生积累的美食经验又缺乏有效的分享渠道。
我去年指导过一组学生完成类似项目，他们调研发现：83%的大学生每周至少3次在校外就餐，但其中61%表示"经常为吃什么发愁"。这个数据说明，一个整合校园周边餐饮信息、提供真实评价和推荐功能的平台确实存在市场需求。
从技术角度看，这个项目涵盖了Spring Boot的核心技术栈：
- 前端：Thymeleaf模板引擎 + Bootstrap响应式布局
- 后端：Spring MVC + Spring Data JPA + MySQL
- 特色功能：基于地理位置的美食推荐、用户评分系统、评论互动
提示：选择校园周边美食作为毕设主题的优势在于：
- 数据采集方便，可直接实地调研
- 业务场景明确，需求文档容易编写
- 技术栈主流，答辩时老师容易理解
2. 系统架构设计
2.1 技术选型决策
在项目启动阶段，我们对比了三种常见的技术组合方案：
| 方案 | 技术栈 | 适合场景 | 本项目适用性 |
|---|---|---|---|
| 方案A | Spring Boot + JPA + Thymeleaf | 快速开发、中小型项目 | ★★★★★ |
| 方案B | Spring Boot + MyBatis + Vue | 前后端分离、复杂交互 | ★★★☆☆ |
| 方案C | Django + PostgreSQL | Python技术栈、数据密集型 | ★★☆☆☆ |
选择方案A的主要考虑：
- 毕业设计周期通常较短（2-3个月），需要快速产出
- JPA的自动建表功能大幅减少SQL编写工作量
- Thymeleaf学习曲线平缓，适合Java基础的学生
2.2 核心模块划分
系统采用经典的三层架构，关键包结构如下：
code复制com.campusfood
├── config # Spring配置类
├── controller # 控制器层
├── service # 业务逻辑层
├── repository # 数据访问层
├── entity # 实体类
├── dto # 数据传输对象
└── util # 工具类
实体关系设计是项目的核心难点。经过三次迭代，我们最终确定的ER图包含6个主要实体：
- User（用户）
- Restaurant（餐厅）
- Food（菜品）
- Review（评价）
- Favorite（收藏）
- Tag（标签）
其中User与Restaurant之间通过Review形成多对多关系，这种设计支持：
- 用户对同一餐厅多次评价
- 餐厅展示所有历史评价
- 基于用户评价的推荐算法
3. 关键功能实现
3.1 基于地理位置的美食推荐
这是项目的特色功能，实现流程如下：
- 前端获取用户地理位置（需浏览器授权）
javascript复制navigator.geolocation.getCurrentPosition(
position => {
const {latitude, longitude} = position.coords;
// 发送到后端API
}
);
- 后端处理位置数据并计算距离
java复制public List<Restaurant> findNearby(double userLat, double userLon, double radius) {
return restaurantRepository.findAll().stream()
.filter(r -> calculateDistance(userLat, userLon, r.getLatitude(), r.getLongitude()) <= radius)
.sorted(comparingDouble(r -> calculateDistance(userLat, userLon, r.getLatitude(), r.getLongitude())))
.collect(Collectors.toList());
}
// 使用Haversine公式计算球面距离
private double calculateDistance(double lat1, double lon1, double lat2, double lon2) {
// 具体实现省略...
}
- 结果按距离排序并返回前端
注意：实际项目中应考虑数据库层面优化，可使用MySQL的空间索引或PostGIS扩展，而不是在Java中过滤计算。
3.2 用户评价系统
评价功能看似简单，但有几个易错点需要特别注意：
- 防止XSS攻击：前端输入需要转义
java复制public String escapeHtml(String input) {
return StringEscapeUtils.escapeHtml4(input);
}
- 事务处理：评价涉及多个表的更新
java复制@Transactional
public void addReview(ReviewDTO reviewDTO) {
Review review = convertToEntity(reviewDTO);
reviewRepository.save(review);
// 更新餐厅平均评分
Restaurant restaurant = review.getRestaurant();
double newAvg = reviewRepository.getAverageRating(restaurant.getId());
restaurant.setAverageRating(newAvg);
restaurantRepository.save(restaurant);
}
- 性能优化：使用@CacheEvict更新缓存
java复制@CacheEvict(value = "restaurant", key = "#reviewDTO.restaurantId")
public void addReview(ReviewDTO reviewDTO) {
// 方法实现...
}
4. 项目部署与测试
4.1 多环境配置
毕业设计答辩时经常需要现场演示，推荐配置三种环境：
- 开发环境（application-dev.properties）
properties复制spring.datasource.url=jdbc:mysql://localhost:3306/campusfood_dev
spring.jpa.hibernate.ddl-auto=update
- 测试环境（application-test.properties）
properties复制spring.datasource.url=jdbc:mysql://test-server:3306/campusfood_test
spring.jpa.hibernate.ddl-auto=validate
- 生产环境（application-prod.properties）
properties复制spring.datasource.url=${DB_URL}
spring.jpa.hibernate.ddl-auto=none
切换环境只需在启动时指定profile：
bash复制java -jar campusfood.jar --spring.profiles.active=prod
4.2 接口测试方案
使用Postman进行接口测试时，建议创建以下测试集合：
-
用户认证测试
- 注册 → 登录 → 获取JWT → 访问受保护接口
-
餐厅查询测试
- 分页查询 → 条件过滤 → 距离排序
-
评价流程测试
- 提交评价 → 查看评价 → 删除评价
特别要注意边界测试：
- 提交空评价内容
- 评分超过5分
- 不存在的餐厅ID
5. 常见问题与解决方案
5.1 跨域问题处理
开发前后端分离版本时，跨域是必遇问题。推荐两种解决方案：
方案一：全局配置（适合简单项目）
java复制@Configuration
public class CorsConfig implements WebMvcConfigurer {
@Override
public void addCorsMappings(CorsRegistry registry) {
registry.addMapping("/**")
.allowedOrigins("*")
.allowedMethods("*");
}
}
方案二：细粒度控制（推荐生产环境使用）
java复制@Configuration
public class CorsConfig {
@Bean
public WebMvcConfigurer corsConfigurer() {
return new WebMvcConfigurer() {
@Override
public void addCorsMappings(CorsRegistry registry) {
registry.addMapping("/api/**")
.allowedOrigins("https://yourdomain.com")
.allowedMethods("GET", "POST");
}
};
}
}
5.2 文件上传限制
用户上传美食图片时，Spring Boot默认有1MB限制。需要调整配置：
properties复制spring.servlet.multipart.max-file-size=5MB
spring.servlet.multipart.max-request-size=5MB
同时应在Controller中添加异常处理：
java复制@ExceptionHandler(MaxUploadSizeExceededException.class)
public ResponseEntity<String> handleSizeExceeded() {
return ResponseEntity.badRequest().body("文件大小超过5MB限制");
}
6. 项目扩展建议
如果想提升项目难度以获得更高评分，可以考虑以下扩展方向：
-
智能推荐算法
- 基于用户历史行为的协同过滤
- 结合天气、时间的场景化推荐
-
微信小程序端
- 使用uni-app跨平台开发
- 对接微信登录和支付
-
数据可视化
- 使用ECharts展示餐厅热度趋势
- 用户口味偏好分析
-
后台管理系统
- 使用Spring Boot Admin监控应用状态
- 添加餐厅数据导入导出功能
我在实际项目评审中发现，那些获得优秀成绩的毕设通常具备以下特点：
- 有完整的需求分析文档（不少于20页）
- 实现了1-2个技术亮点（如WebSocket实时通知）
- 包含详细的测试报告（单元测试覆盖率>60%）
- 部署文档完整（含Dockerfile和CI/CD配置）
最后分享一个实用技巧：使用Git进行版本控制时，建议按功能拆分分支（如feat/geolocation、fix/review-bug），而不是所有修改都在master分支进行。这能让你的开发过程更规范，也方便在答辩时展示项目演进历程。