甘肃非遗文化展示网站，这个选题在Java毕设里算是经典中的经典了。我见过不少人拿它交作业，但真正能把整个项目吃透、能从零讲清楚设计思路的没几个。这篇文章我不打算给你贴一堆代码，而是从项目拆解的角度，把Spring Boot非遗网站从需求分析到部署上线的完整链路捋一遍。无论你是刚开始选题、写了一半卡住，还是准备答辩前恶补细节，这篇内容都能给你提供一套可以直接参考的落地思路。
1. 项目整体设计与思路拆解
1.1 核心需求解析
甘肃非物质文化遗产资源非常丰富，花儿、敦煌舞、庆阳香包、临夏砖雕、兰州牛肉面制作技艺等都是国家级非遗项目。然而这些文化资源往往散落在各种线下展馆、纸质资料和新闻报道中，缺乏一个集中的线上展示平台。
因此，这个项目的核心需求非常明确：做一个基于Spring Boot的甘肃非遗文化展示网站，让用户可以在线浏览非遗项目介绍、传承人故事、相关资讯动态，同时让管理员可以通过后台系统维护这些内容。
从毕设的角度来看，这个题目讨巧的地方在于三点：
- 业务场景清晰：非遗文化展示，业务逻辑不复杂，但又有足够的实体关系可以设计，适合用来展示数据库设计能力。
- 技术栈主流：Spring Boot + MyBatis-Plus + MySQL + Vue这组合，既是企业主流，又是毕设答辩时评委最熟悉的组合。
- 扩展空间大：既可以做成纯展示型网站，也可以加入用户登录、收藏、评论、搜索等功能，难度可以灵活调节。
1.2 技术选型背后的逻辑
我最初做这个项目的时候，其实犹豫过要不要用Spring Cloud那一套。后来想明白了，毕设项目最重要的是“把一道菜做熟，而不是摆一桌满汉全席”。单体应用加上合理分层，足够支撑起这个项目的所有业务场景。
技术栈的选择逻辑是这样的：
- Spring Boot 2.x：简化配置，内置Tomcat，一条命令就能启动，极大降低环境搭建成本。选2.x而不是3.x，是因为2.x的资料最多，遇到问题更容易搜到解决方案。
- MyBatis-Plus：最核心的卖点是代码生成器和条件构造器。对于非遗网站这种需要写大量单表CRUD的项目，MyBatis-Plus能省下将近三分之一的工作量。
- MySQL 8.0：存储非遗项目、传承人、新闻资讯这些结构化数据，搭配Druid连接池做监控。
- Vue + Element-UI：后台管理界面用现成的组件库，不用自己手搓UI，把精力集中在业务逻辑上。
- JWT + 拦截器：用于后台管理接口的身份认证，比传统的Session方案更适合前后端分离架构。
1.3 功能模块划分
整个系统分为前台展示和后台管理两个大端，前台面向普通访客，后台面向管理员。
前台模块包括：
- 非遗项目展示：按照传统舞蹈、传统音乐、传统技艺、民俗等类别分类展示。
- 项目详情页：展示非遗项目的详细介绍、历史渊源、传承谱系、代表作品等信息。
- 传承人风采：展示国家级、省级非遗传承人的故事和作品。
- 资讯动态：发布非遗相关的新闻、活动通知、政策文件。
- 站内搜索：支持按名称、类别、简介关键词搜索非遗内容。
后台模块包括：
- 管理员登录认证
- 非遗项目管理（增删改查、上架下架）
- 传承人管理
- 资讯管理
- 分类管理
- 首页轮播图管理
- 数据统计（简单的访问量统计）
这七个功能模块覆盖了一个完整内容管理系统的所有核心场景。我见过有些同学喜欢往项目里堆功能，比如加购物车、加支付、加在线订票之类，我的建议是：除非你对这些功能的业务逻辑特别熟悉，否则不要加。功能越多，漏洞越多，答辩被问倒的风险也越高。
2. 数据库设计与核心实现
2.1 表结构设计思路
数据库设计是这个项目第一个真正的硬骨头。设计得好不好，可以直接从表结构里看出来。我强烈建议你在建表之前，先画出概念模型（ER图），再审一遍是否有循环依赖、是否有冗余字段。
非遗项目网站的核心表有六张：用户表、非遗项目表、项目分类表、传承人表、资讯表、轮播图表。
非遗项目表（heritage_item）是核心，我把它的字段结构列出来供参考：
| 字段名 | 类型 | 说明 |
|---|---|---|
| id | bigint | 主键 |
| name | varchar(100) | 非遗项目名称 |
| category_id | bigint | 所属分类ID |
| level | varchar(20) | 级别（国家级/省级/市级） |
| region | varchar(100) | 所属地区（如临夏州、敦煌市） |
| cover_image | varchar(255) | 封面图URL |
| introduction | text | 项目简介 |
| historical_bg | text | 历史渊源 |
| inheritance | text | 传承谱系 |
| representative_works | text | 代表作品 |
| status | tinyint | 状态（1展示/0隐藏） |
| view_count | int | 浏览次数 |
| create_time | datetime | 创建时间 |
| update_time | datetime | 更新时间 |
注意到没有，我把项目详情拆成了多个text字段，而不是塞进一个大content字段。这样做的原因是：非遗项目的详情内容通常较长，而且在列表页只需要展示name、cover_image、introduction，分开存储可以减少非必要的磁盘IO。
2.2 数据访问层的工程化实现
数据访问层我统一用MyBatis-Plus实现，没有写一行XML SQL（除了几个多表联查）。
关键的几个点：
- BaseMapper泛型：所有Mapper继承BaseMapper后，内置的selectById、selectList、insert方法直接可用。
- 分页插件：配置PaginationInnerInterceptor后，只需要传入Page对象，分页SQL会自动追加limit。
- 条件构造器LambdaQueryWrapper：支持链式查询条件，比如筛选某个分类下的国家级项目，可以这样写：
LambdaQueryWrapper<HeritageItem> wrapper = new LambdaQueryWrapper<>(); wrapper.eq(HeritageItem::getCategoryId, categoryId) .eq(HeritageItem::getLevel, "国家级") .eq(HeritageItem::getStatus, 1) .orderByDesc(HeritageItem::getViewCount);这种写法最直观的好处是类型安全。直接用字段名对应的Lambda表达式，不会出现列名拼写错误的问题，编译期就能发现。
2.3 后台管理接口封装
后台管理接口我遵循一套统一的Restful风格规范。比如非遗项目管理的接口：
| 接口路径 | 方法 | 说明 |
|---|---|---|
| /admin/heritage/list | GET | 分页查询项目列表 |
| /admin/heritage/{id} | GET | 查询项目详情 |
| /admin/heritage | POST | 新增项目 |
| /admin/heritage/{id} | PUT | 更新项目信息 |
| /admin/heritage/{id} | DELETE | 删除项目 |
统一返回结果我用了一个Result实体类包了一层，包含code、message、data三个字段。这样做的目的是让前后端联调时有一个约定好的数据格式，后端返回异常时前端也能统一处理。
注意：后台管理相关接口，务必加上JWT认证校验。我当时是在拦截器里做了白名单配置，/admin/开头的请求全部需要携带合法token，前台的展示接口则全部放行。
3. 前台展示端的核心技术点
3.1 首页动态推荐机制
首页的展示策略，直接决定了用户的第一印象。我当时设计了一个“基于浏览量加权的推荐位”功能：查询项目列表时，按照view_count降序排列，取前六条作为热门推荐。
这个策略比较简单，但运维成本为零，而且效果不错。如果你想让推荐更灵活一些，可以在项目表里加一个is_recommend字段，由管理员手动控制推荐位，两种方案都可行。
3.2 分类筛选与搜索实现
分类筛选的逻辑很好写，就是根据categoryId过滤数据。真正难的是搜索。直接使用MySQL的like查询，数据量小的时候没感觉，但表里一旦有几万条记录，性能就会明显下降。
对于这个毕设项目，我的建议是使用MySQL的全文索引，而不是死磕like。在数据库层面执行：
ALTER TABLE heritage_item ADD FULLTEXT INDEX ft_search (name, introduction);然后使用MATCH AGAINST语法查询：
SELECT * FROM heritage_item WHERE MATCH(name, introduction) AGAINST('敦煌' IN NATURAL LANGUAGE MODE);这一步做不做，可能只有两三分的影响。但答辩时你要是能说出来“考虑到数据量增长，选择了MySQL全文索引来替代like查询”，评委的印象分会不一样。
3.3 图片上传与访问路径处理
非遗项目展示类网站，图片是灵魂。我当时处理图片上传的方式是：本地磁盘存储 + 虚拟目录映射。
具体操作分三步：
- 在application.yml里配置上传路径：
file: upload-path: /data/nonheritage/images/ access-path: /images/**- 写一个WebMvcConfigurer配置类，把上传目录映射为静态资源访问：
@Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler("/images/**") .addResourceHandler("file:" + uploadPath); }- 前端图片的访问路径直接写成相对路径
/images/xxxx.jpg。
这种方案的好处是入门简单、本地架包即用。缺点是服务器重启或迁移时需要保证目录一致，而且单机磁盘容量有限。不过对于毕设项目来说，这个方案性价比最高。不推荐在毕设里引入OSS对象存储，除非你本身对云服务特别熟。
4. 项目环境搭建与部署实操
4.1 本地开发环境清单
在开始动工之前，先把环境统一好，能省掉大量踩坑时间。我的建议版本如下：
| 组件 | 版本 | 说明 |
|---|---|---|
| JDK | 1.8 | Spring Boot 2.x的基础要求 |
| Maven | 3.6+ | 依赖管理和项目构建 |
| MySQL | 8.0+ | 数据库，编码统一utf8mb4 |
| Node.js | 14+ | 前端构建环境 |
| IDEA | 2022+ | 开发IDE |
这里有一个非常大的坑要提醒你：数据库连接串一定要加characterEncoding=utf8mb4&serverTimezone=Asia/Shanghai，否则中文插入时会乱码，时间字段会差8个小时。
4.2 从零搭建项目骨架（实操）
整个搭建流程可以拆成六步，每一步完成什么、验证什么，都要心里有数。
第一步：创建数据库
CREATE DATABASE nonheritage CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;第二步：生成Spring Boot基础工程
用IDEA的Spring Initializr创建工程，勾选Web、MySQL Driver、MyBatis-Plus依赖。如果IDEA初始化时拉取依赖失败，检查Maven的settings.xml是否配置了阿里云镜像仓库。
第三步：编写核心配置
application.yml里最核心的一段配置如下：
spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/nonheritage?characterEncoding=utf8&serverTimezone=Asia/Shanghai username: root password: yourpassword type: com.alibaba.druid.pool.DruidDataSource servlet: multipart: max-file-size: 10MB max-request-size: 30MB mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl map-underscore-to-camel-case: true global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0map-underscore-to-camel-case: true这个配置作用巨大——数据库字段create_time能自动映射成Java实体里的createTime，省掉一堆@TableField注解。
第四步：使用代码生成器
MyBatis-Plus的代码生成器（AutoGenerator）可以根据数据库表反向生成实体类、Mapper接口、Mapper XML、Service、Controller。生成之后记得把Controller里的参数校验补完整，代码生成器可不会帮你写参数非空校验。
第五步：配置CORS跨域
前后端分离，跨域必配。我在项目里写了一个CorsConfig：
@Configuration public class CorsConfig { @Bean public CorsFilter corsFilter() { CorsConfiguration config = new CorsConfiguration(); config.addAllowedOriginPattern("*"); config.addAllowedHeader("*"); config.addAllowedMethod("*"); config.setAllowCredentials(true); UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource(); source.registerCorsConfiguration("/**", config); return new CorsFilter(source); } }注意，如果使用了JWT认证，CORS的allowedOrigin不能简单地设为*，要使用addAllowedOriginPattern("*")，否则携带凭证的请求会被浏览器拦截。
第六步：启动验证
启动Spring Boot应用，访问http://localhost:8080/api/heritage/list，如果能正常返回JSON数据，说明后端骨架已经搭通了。
4.3 部署环境的关键调整
为了方便最终演示和答辩，我把项目部署在了一台云服务器上（操作系统为Linux CentOS 7）。部署方式和本地有几点不同：
- MySQL允许远程连接：需要修改bind-address为0.0.0.0，并授权远程访问账号。
- 前端打包：Vue项目执行
npm run build后生成dist目录，用Nginx托管。 - 后端打包：执行
mvn clean package -DskipTests生成jar包，使用nohup java -jar命令后台运行。 - 反向代理配置：配置Nginx，把
/api路径代理到后端的8080端口。
这里有一个容易被人忽略的细节：前端部署后，接口地址不要再写localhost，要改成服务器的公网IP或域名。我在第一次部署时就因为前端包里的axios baseURL写的是localhost，导致线上页面完全无法请求到数据，排查了很久才发现这个低级错误。
5. 常见问题与排查技巧实录
5.1 数据库连接报错
报错内容：Access denied for user 'root'@'localhost'
原因与解决：MySQL 8.0的默认认证插件是caching_sha2_password，而低版本的JDBC驱动不支持。解决方案是在MySQL里执行：
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'yourpassword';或者在pom.xml里升级mysql-connector-java到8.0.28以上。
5.2 页面加载中文乱码
原因：数据库字段为utf8编码，但前端页面以GBK解析；或者数据库连接串没有声明字符集。
解决：统一使用utf8mb4，包括数据库、表、连接串、前端HTML的meta标签。排查顺序是从上到下确认：数据库默认字符集、表字段字符集、JDBC连接串、后端Response编码。
5.3 分页查询失效
原因：MyBatis-Plus的分页插件没有注册。很多人引入了mybatis-plus-boot-starter，但没有写MybatisPlusInterceptor配置，导致分页查询返回全部数据。
解决：配置一个分页拦截器的Bean：
@Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; }5.4 文件上传返回404
原因：虚拟目录映射的路径和实际磁盘路径不一致。
解决：检查相对路径。确保addResourceHandler里的模式匹配到前端浏览器请求的URL，同时addResourceLocations里的file路径以/结尾。
5.5 后台接口报401
原因：JWT token过期、请求头没带token、或者token被拦截器解析失败。
解决：前端在axios请求拦截器里统一加上Authorization请求头。后端在JWT工具类里打印解析异常信息，方便定位是格式错误还是过期。
5.6 服务器上宝塔面板Mysql版本问题
报错：Unknown character set: 'utf8mb4'
原因：低于5.5.3版本的MySQL不支持utf8mb4字符集。
解决：方案有两个：一是把数据库连接串上的characterEncoding=utf8mb4改成utf8；二是升级MySQL数据库版本。个人建议直接升级数据库，因为utf8mb4就是为完整支持中文和特殊字符而生的。
6. 实操心得与建议
做完这个项目之后，我最大的体会有三件事。
第一，一定要敢于动手连数据库。我在这个项目里踩过的所有坑，几乎都跟“想法和实际不一致”有关，键盘敲出来的SQL、浏览器发出的请求、数据库里的记录，三者对应不上，问题就出现了。先把环境跑通，再讨论优化，这样才能保障开发效率。
第二，代码生成器要会用，但不能依赖。MyBatis-Plus的代码生成器确实能省不少时间，但生成出来的代码只是骨架，事务控制、权限校验、异常处理这些还是要自己手写。如果你直接把生成的代码一股脑交上去，答辩时一问一个准。
第三，前端页面比想象中的重要。非遗文化网站，展示的就是文化和审美。哪怕后端写得再好，前端页面丑，整体评价也会受影响。建议用Element-UI的组件库，搭配一些具有传统纹样风格的CSS细节，比如红褐色主色调搭配米白背景，整体观感会明显提升。
最后再分享一个小技巧：代码里多写注释，特别是那些接口方法、核心业务逻辑的注释。写注释这件事，短期内看是浪费时间，长期看是在帮未来的自己省钱。答辩前你会感谢当初写注释的自己。
