基于SpringBoot的农村风貌展示平台：从需求到落地的完整毕设实战-开发者社区

做毕业设计这些年，我见过太多同学一上来就问“有没有现成系统”，结果拿到的代码跑都跑不起来，更别说讲清楚自己做了什么。今天我想认真拆一个非常适合计算机专业学生参考的题目：基于SpringBoot的农村综合风貌展示平台。这个项目听起来不复杂，但它把乡村数字化、内容展示、后台管理、小程序端全部串在一起，知识覆盖面非常广，拿来当毕设、课程设计或者简历里的项目，都很能打。

这个平台到底能做什么？简单说，就是把一个村庄的景点、文化、产业、村容村貌等内容，通过网页和小程序统一展示出来。村民可以发动态，游客可以浏览、点赞、评论，管理员在后台维护信息。从技术角度看，它既要解决数据管理问题，也要解决多端展示问题，还要考虑权限控制、图片存储、搜索筛选这些日常开发里一定会遇到的细节。对于想搞明白SpringBoot全家桶怎么落地的人来说，这就是一个缩小版的企业级应用。

我下面会按我自己做这类项目的习惯，把整个项目从需求分析、技术选型、数据库设计到核心代码、踩坑记录全部过一遍。内容偏实操，前后端都有，如果你打算自己写一遍，可以直接照着做。

1. 项目到底在解决什么问题

1.1 农村风貌展示的尴尬现状

先聊点实际的。你去搜“农村风采展示”，绝大多数地方还停留在公众号推文、宣传册、政府网站静态栏目这些形式。信息更新慢、内容零散、游客想找个村子的特色景点得翻好几层网页，村民想发个自家农产品动态也没有入口。这个毕设题目看准的正是这个缺口：做一个能让村里内容自主更新、游客可以交互、管理员统一管控的展示平台。

所以它不是一个普通的“网页展示”，而是“内容管理系统 + 公众端展示 + 移动端适配”的组合体。用户端看到的是干净美观的风貌页，管理端做的是内容录入、审核、分类、排序。这种结构正好对应了互联网产品里最常见的B端和C端分离模式，做完这个项目，你对权限设计、数据隔离、接口设计都会有实感。

1.2 这个项目适合谁来做

如果你还在纠结毕设选什么方向，这个题目很适合。第一，需求明确但不复杂，工作量可控，一个人做完不会觉得空；第二，技术栈主流，SpringBoot + MyBatis/MyBatis-Plus + MySQL + Vue/小程序，面试时可以拿去聊的东西很多；第三，扩展空间大，后面想加地图导航、VR全景、农产品商城、留言板都可以在原有架构上加。

如果你是电子信息或者嵌入式方向的同学，想掺一些单片机元素，也可以把项目延伸成“环境数据展示平台”，用传感器采集温度、湿度、空气质量，再通过接口把数据上传到这个SpringBoot后端，前端用图表展示。这样就把Java后端和硬件串起来了，答辩时更有亮点。

2. 技术选型：为什么是SpringBoot而不是别的

2.1 后端为什么选SpringBoot

很多人第一个问题就是：能不能用Servlet/JSP做？能做，但我不建议。纯Servlet写一个带用户、评论、分类、多表查询的项目，代码量会爆炸，而且你处理JSON、事务、文件上传都要自己封装，调试成本很高。SpringBoot的核心理念是“自动配置 + 约定大于配置”，你只要引入依赖，写少量配置就能把Web应用跑起来，把精力放在业务上。

我自己的标配是：SpringBoot 2.7.x + MyBatis-Plus + MySQL 8.0 + Redis（非必须）。SpringBoot 2.7已经很成熟，网上资料多，Java 8或Java 11都兼容，完全够毕业设计用。MyBatis-Plus帮我省掉大量单表CRUD的重复代码，比如分页查询、条件构造器，写起来很爽。

提示：不建议一上来就上SpringBoot 3.x + JDK 17，除非你对新特性很熟。毕设重点是跑通业务，不是追逐最新版本。官方文档虽然好，但很多第三方教程还停留在2.x时代，遇到版本坑会耽误时间。

2.2 前端展示端怎么选

在这个项目里，公众端至少有两个我们需要考虑：一个是PC网页，另一个是移动端。PC端用Vue 2或Vue 3都可以，如果你的基础一般，直接使用服务端渲染的Thymeleaf模板也能做出来。但考虑到现在评委老师都喜欢看到“前后端分离”，我会用Vue 3 + Element Plus做一个管理后台，再单独做一个微信小程序用于移动端浏览。

微信小程序这块，最大的好处是省去App的安装分发流程，用户扫码就能看。小程序端不用做得特别重，重点是展示风貌列表、详情、评论入口和个人登录。通过uni-app开发的话，还能打包成H5和各个小程序平台，代码复用率很高，对毕设来说性价比极高。

2.3 数据存储与工具链

数据库选择MySQL，理由不多说，主流、免费、资料多。如果是并发要求不高的毕设系统，单库单表就够。缓存看个人情况，建议加一个Redis存热门景点点击量，如果不想折腾环境，也可以先不加，用数据库字段累加。

文件这块，风貌平台跑不了要上传图片，本地目录上传是最简单的，做一个upload目录映射成静态资源访问路径就行。如果你想让项目显得更专业，可以用MinIO自建对象存储，或者用云存储的SDK接入。注意，毕设阶段别为了“高级”把架构做复杂，上传本地磁盘加上数据库记录相对路径，已经能说明你掌握了文件处理逻辑。

3. 数据库设计：先把表结构想清楚

3.1 核心实体拆解

做这个项目之前，我建议先画一个简单的业务流程图，把“谁在什么角色下做什么事”理清楚。常见的角色有：游客、注册用户、内容管理员、超级管理员。

核心实体大概有：

用户表（user）：注册用户、管理员都放这里，通过role字段区分。
风貌分类表（category）：比如自然风光、历史人文、特色产业、村容村貌。
风貌信息表（scenery）：平台上展示的核心内容，标题、封面图、正文、作者、状态、浏览量。
评论表（comment）：用户对风貌内容的评论。
点赞表（like_record）：记录谁给哪个内容点了赞，防止重复点赞。
动态公告表（notice）：平台通知、公告信息。
轮播图表（banner）：首页轮播图维护。

3.2 表结构设计要点

我拿scenery表举个例子，字段不能乱写。

CREATE TABLE scenery ( id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '主键', title VARCHAR(100) NOT NULL COMMENT '标题', category_id BIGINT NOT NULL COMMENT '分类ID', cover_image VARCHAR(255) COMMENT '封面图URL', images TEXT COMMENT '多图，可用JSON数组存', content LONGTEXT COMMENT '详细介绍', author_id BIGINT COMMENT '发布人ID', status TINYINT DEFAULT 0 COMMENT '状态:0草稿,1已发布,2下架', view_count INT DEFAULT 0 COMMENT '浏览量', like_count INT DEFAULT 0 COMMENT '点赞数', sort INT DEFAULT 0 COMMENT '排序权重', create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

几个比较容易忽略的点：

charset要选utf8mb4，因为用户评论和正文里很可能有表情符号，utf8mb4才能正确存储。
status字段一定要有，发布/下架是最基础的内容管控逻辑。
sort字段很多人会漏，但它能实现管理员在后台拖拽排序，不管前端是否展示，先留着。
images用TEXT存JSON数组，是最省事的方案，虽然不符合严格的范式，但对这种展示类项目完全够用，也能减少多表关联。

点赞表要保证用户和内容不能重复点赞，最原始的做法是unique key：

CREATE TABLE like_record ( id BIGINT PRIMARY KEY AUTO_INCREMENT, user_id BIGINT NOT NULL, target_id BIGINT NOT NULL, target_type TINYINT DEFAULT 0 COMMENT '0表示点赞风貌', create_time DATETIME DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_user_target (user_id, target_id, target_type) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

这样数据库层面就挡住了重复点赞。业务逻辑虽然要判断，但数据库约束是底线。

4. 核心功能拆解与代码落地

4.1 后端：项目分层与接口设计

项目包结构我习惯这样分：

controller：接收请求、返回结果
service：业务逻辑
mapper：数据库操作
entity：实体类
dto：前端传参对象和返回对象
config：配置类
common：统一返回结果、异常处理、工具类

为什么要分层？不是为了好看，是为了可维护。比如评论功能，controller里只做参数校验和调用service，真正的业务逻辑放在service里，这样后面加“评论需要审核”这个需求，只需要改service，不用动controller。

统一返回结果非常重要。我通常定义一个Result类：

{ "code": 200, "message": "success", "data": {...} }

前端不管是Vue还是小程序，都按这个格式解析。只要能保证code为200就是成功，其他都是失败，前端可以减少大量判断。

接口设计上，先列一份清晰的API清单再写代码。比如：

POST /api/auth/login 用户登录
POST /api/auth/register 注册
GET /api/scenery/list 分页获取风貌列表
GET /api/scenery/detail/{id} 获取详情
POST /api/comment/add 发表评论
GET /api/comment/list 查看评论
POST /api/like/toggle 点赞/取消点赞
GET /api/category/list 获取分类列表
POST /api/admin/scenery/save 管理员保存风貌
POST /api/admin/user/disable 禁用用户

接口地址命名尽量用资源名，不要用动词堆砌，比如不要写/getAllScenery，而是用GET + /scenery/list。这种REST风格虽然不完全严格，但已经足够毕设展示。

4.2 风貌列表接口怎么写

风貌列表是平台的首页核心，必须做分页和条件筛选。用MyBatis-Plus会很简单：

public IPage<SceneryVO> getSceneryPage(SceneryQuery query) { Page<Scenery> page = new Page<>(query.getPageNum(), query.getPageSize()); LambdaQueryWrapper<Scenery> wrapper = new LambdaQueryWrapper<>(); wrapper.eq(Scenery::getStatus, 1) .eq(query.getCategoryId() != null, Scenery::getCategoryId, query.getCategoryId()) .like(StringUtils.hasText(query.getKeyword()), Scenery::getTitle, query.getKeyword()) .orderByDesc(Scenery::getSort) .orderByDesc(Scenery::getCreateTime); return sceneryMapper.selectPage(page, wrapper); }

这里有两点要注意。

第一，状态必须过滤。用户端不能看到未发布的草稿，这是基础安全规则。

第二，条件构造器里，eq的condition参数传一个boolean表达式，MyBatis-Plus会在条件不成立时自动忽略这个条件，避免了拼SQL的if地狱。这个写法到真实项目里也常见，评委听了会觉得你有工程意识。

视图对象（VO）不要直接把entity返回给前端。比如scenery表里可能有status、create_time，这些字段用户端不一定需要，而且字段多了响应体也臃肿。我会创建SceneryVO，只保留id、title、coverImage、categoryName、viewCount、likeCount、createTime这些展示字段。

4.3 登录与权限控制

登录是绕不开的功能。毕业设计最常见的是JWT方案，流程是：用户提交用户名密码 -> 后端校验 -> 生成Token返回前端 -> 前端后续请求带上Token -> 后端拦截器解析Token并拿到用户信息。

实现上我一般用jjwt库，生成一个带过期时间的Token，密码通过BCrypt加密存储。这里必须强调：密码不能明文存数据库，这是安全问题，也是加分项。

权限控制上，我用自定义拦截器，把需要登录的接口放到一个路径下，比如/admin/，然后在拦截器里判断是否存在合法Token。简单做法：

public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String token = request.getHeader("Authorization"); // 解析token，失败则返回401 // 成功则把userId放入request attribute return true; }

如果是学生项目，不一定要引入Spring Security，它虽然强大，但是配置复杂度高，很容易把时间耗在过滤链配置上。用拦截器的方式，你能讲清楚“认证”和“鉴权”两个概念就够了。真正需要做角色判断时，再在方法上判断user.getRole()，比如只有管理员才能访问后台接口。

4.4 管理后台：文件上传与富文本

风采展示平台绕不开图片上传。我在后台提供一个上传接口，接收MultipartFile，保存到本地目录，然后把访问路径返回给前端：

String fileName = UUID.randomUUID().toString().replace("-", "") + getExtension(file.getOriginalFilename()); String fileDir = "upload/images/"; String realPath = resourceProperties.getUploadPath() + fileDir; File dest = new File(realPath, fileName); file.transferTo(dest);

这里我习惯自己生成文件名，不要用用户上传的原始文件名，避免路径穿越和中文乱码问题。原始文件名只能取扩展名，这个是安全习惯。

富文本编辑器，后台可以集成wangEditor或者TinyMCE。注意富文本里的图片是base64还是URL，如果图片多，建议编辑器配置成上传图片返回URL，不要把base64整段存进数据库，否则数据库会迅速膨胀，页面加载也会卡。

4.5 小程序端：从接口到页面

小程序端我建议按“首页风采列表 -> 分类切换 -> 详情页 -> 评论区 -> 个人中心”来做。首页用scroll-view做滚动加载，触底时调用下一页接口。这个分页交互几乎是所有内容类小程序的标准玩法，必须熟练掌握。

接口请求封装也简单，就是uni.request或者wx.request，封装一层：

const BASE_URL = 'http://localhost:8080/api'; function request(path, method, data) { return new Promise((resolve, reject) => { uni.request({ url: BASE_URL + path, method, data, header: { 'Authorization': uni.getStorageSync('token') || '' }, success: (res) => { if (res.data.code === 200) { resolve(res.data.data); } else { uni.showToast({ title: res.data.message, icon: 'none' }); } }, fail: reject }); }); }

登录在小程序里一般用微信登录，但毕设场景里也需要让用户能模拟登录。最简单的方式是做一个“微信授权登录”和“用户名密码登录”都支持的方案。如果不想在小程序端做注册，可以让小程序用户首次打开时创建游客身份，操作评论或点赞前再引导登录。

有一点我特别想提醒：本地调试小程序时，域名必须在小程序后台配置request合法域名。如果只是毕设演示，可以在开发者工具里勾选“不校验合法域名”，但如果要部署上线，一定要配HTTPS域名。

5. 实操过程中最容易踩的坑

5.1 环境配置的坑

很多项目跑不起来，不是代码问题，是环境问题。Java环境变量、Maven仓库、MySQL版本、端口占用，每一环都能卡半天。我建议按这个顺序排查：

java -version 看Java版本，如果是17却说用的SpringBoot 2.7，兼容性没问题，但如果用到某些低版本Java库可能会报错。
mvn -v 看Maven配置，确认settings.xml里的本地仓库路径是不是自己想要的。
MySQL数据库启动后，注意字符集，如果创建表时没指定utf8mb4，后续插入中文可能报错。
端口8080被占用，是本地开发最常见问题。Windows下用netstat -ano | findstr 8080找到进程，或者在SpringBoot配置里改端口解决。

5.2 前后端联调遇到跨域

前后端分离后，前端地址是localhost:8081，后端是localhost:8080，跨域问题跑不掉。SpringBoot里加一个跨域配置类就能解决：

@Configuration public class CorsConfig { @Bean public CorsFilter corsFilter() { CorsConfiguration config = new CorsConfiguration(); config.addAllowedOriginPattern("*"); config.addAllowedMethod("*"); config.addAllowedHeader("*"); UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource(); source.registerCorsConfiguration("/**", config); return new CorsFilter(source); } }

毕设阶段可以允许全部来源，但你要能说清楚生产环境不会这么配置，需要指定具体的域名白名单。这个细节都说出来，评委就会觉得你不是只会调包。

5.3 图片上传后前端访问不到

这是最常见的问题。上传成功后，你保存的可能是“upload/images/xxx.jpg”，但前端访问的路径是“http://localhost:8080/upload/images/xxx.jpg”，如果后端没有把本地目录映射成静态资源，就会404。

解决方式是在SpringBoot里配置资源映射：

@Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler("/upload/**") .addResourceLocations("file:" + uploadPath + "/"); }

同时注意Windows路径和Linux路径差异，不要硬编码盘符。用配置文件把上传目录和对外访问前缀写成可配置项，这样换环境时不用改代码。

5.4 小程序里图片请求http报错

小程序对网络环境限制很严格，生产环境要求HTTPS，本地调试如果没有关掉域名校验，请求图片地址会出现“image is not allowed in current environment”之类的问题。处理办法是开发阶段在开发者工具工具栏勾选“不校验合法域名、web-view（业务域名）、TLS版本以及HTTPS证书”，发布会话则必须让后端接口支持HTTPS。如果图片也存在本地，需要后端配置HTTPS证书或反向代理。

6. 常见问题速查：答辩前必看

6.1 老师常问的几个点

为什么用SpringBoot？和SSM有什么区别？
SpringBoot算是Spring生态的进一步封装，内置Tomcat，自动配置依赖，让开发者更快起步。SSM需要自己配一大堆XML，SpringBoot把常见配置变成约定，开发效率更高。

MyBatis-Plus好还是MyBatis好？
毕设场景我推荐MyBatis-Plus，它的BaseMapper提供了大量单表CRUD，复杂查询自己写XML，既能保证效率，又能展示你写得来SQL。

权限怎么做的？
用JWT + 拦截器，Token里带用户id和角色，后台接口校验角色。遇到需要更细粒度的数据权限，再按用户id过滤数据。

图片存在哪里？
毕设通常放本地磁盘，数据库只存相对路径，对外通过静态资源映射访问。如果要考虑部署扩展，可以换对象存储，但核心流程不变。

6.2 优化方向可以怎么做

系统做完之后，如果你想让项目更有区分度，可以做这几个扩展：

接入ECharts，在后台做“近7天访问趋势”和“各分类内容占比”图表。
增加搜索历史、热点词汇统计。
用Redis缓存热门列表，减少数据库压力。
在小程序端增加地图组件，接入高德/腾讯地图展示乡村位置。
如果和单片机方向结合，可以加物联网模块，把传感器数据接入后台展示。

这些扩展不需要全部做，挑一个你讲得最清楚、代码能跑通的加上去，就比单纯完成CRUD要有辨识度。

6.3 答辩时的项目讲解框架

讲项目不要从开机页面开始讲，太流水账。我建议按这个顺序：

一句话说明平台服务对象和核心价值：给农村提供统一数字化风貌展示入口，让游客和村民能高效获取内容。
画模块图，说清楚用户端、后台管理端、数据层之间的关系。
挑一个最能体现核心难点的功能深入讲，比如动态权限校验、分页查询、图片上传。
展示能跑通的核心接口和数据库表。
总结遇到的问题和怎么排查。

7. 我的几点实操体会

做这类项目，最忌讳的是“背代码”而不是“懂设计”。如果你是自己从零写的，那知识点肯定扎实；如果你确实时间紧，拿到参考代码，也要把每个模块的调用关系说出来。我见过太多同学把代码跑通就以为完了，结果答辩时一眼代码都不看，PPT上放几个截图，老师随便问一句“评论功能怎么实现防刷”就答不上来。

这个项目我自己做的时候，最大的感受是“内容展示类系统的核心不是功能多，而是数据流清晰”。一个风貌从录入、审核、发布到被浏览、点赞、评论，每一步都有状态和时间记录。把这条链理顺了，你的系统就成功了一大半。

最后分享一个小技巧：在开发过程中，每写完一个接口，就用Postman或者Apifox测试一遍，把请求参数、返回结果截图保存。这些文档不只是调试记录，也是最后写论文和做答辩PPT的素材。真到了写论文阶段，你会发现这些资料比看十篇模板都有用。

基于SpringBoot的农村风貌展示平台：从需求到落地的完整毕设实战