Spring Boot艺术展览导览系统：从需求分析到答辩全流程解析

1. 这个毕设题目的含金量为什么艺术展览导览系统值得细做1.1 一个导览系统到底在解决什么问题先说点实在的。看到Spring Boot艺术展览导览系统这个题目很多人第一反应是这不就是一个带后台的展示网站吗。我最初也这么想但真正开始做需求分析之后才发现导览两个字才是这个项目的灵魂。美术馆和艺术馆的实际痛点很具体线下展签放不下太多文字信息观众走马观花看不出门道遇到特展不知道按什么顺序逛最合理。导览系统要做的就是把展览信息和观展路线两条线拧成一股绳——观众进馆前能看到有哪些展览在开放进馆后能查每一件展品的详细背景参观时能跟着推荐路线把重点展品看全。从毕业设计的评分角度来说这个题目很划算。它不牵扯复杂的算法和硬件但业务闭环是完整的前台有展品浏览、展览列表、导览路线、在线预约、收藏和评论后台有展览管理、展品管理、图片上传、路线编排、评论审核数据层有展览与展品的多对多关系、分类标签、预约日期统计。复杂度适中覆盖面够广答辩时有得讲论文有得写。这是我推荐这个题目的主要原因。1.2 适合什么基础的人上手如果你是零基础我建议先别直接抄这个项目。至少得先把Spring Boot的工程结构、HTTP请求怎么走通、MyBatis Plus的基本CRUD搞清楚再来啃这类完整项目。如果你已经能独立写Controller和Mapper那这个系统就是一台很合适的训练车。它能帮你把几个核心技能点串起来——Controller层的参数校验和统一返回结构、Service层的事务管理、Mapper层动态SQL的写法、前端的路由守卫和后端JWT鉴权怎么配合。另外我最初用Vue做前端后来也试过Thymeleaf模板模式。这两种方案各有侧重后面我会专门讲选型逻辑。2. 需求拆解与角色划分导览系统的边界到底在哪2.1 三类角色各管一摊事在动手写代码之前我花了两天时间把需求理清楚。系统里一共三种角色角色核心诉求主要操作普通观众快速找到展品、了解展览信息浏览展览、查看展品详情、收藏、预约参观、发表评论导览员维护展览内容、设计推荐路线维护展览与展品信息、编排导览顺序、审核评论系统管理员保证系统正常运转用户管理、预约数据查看、基础配置、统计分析这个角色划分不是拍脑袋想的。很多毕设项目只分用户和管理员然后答辩时被问后台内容谁负责录入你一个人既管后台又管账号合理吗就很难答好。引入导览员这个中间角色之后权限模型立刻立体了管理员管人员导览员管内容观众只消费内容。权限控制落到技术上就是接口权限加菜单权限两层。我用Spring Security的注解控制接口访问用前端路由守卫控制菜单显示后面会展开说。2.2 前台三条主线链路前台部分不外乎三件事但每条链路都有值得注意的细节第一条是信息浏览链路展览列表 → 展览详情 → 展品列表 → 展品详情。看起来简单但展品和展览是多对多关系同一件展品可能同时出现在常设展和某个特展里。接口设计上就要通过展览ID去查关联展品而不是让展品表直接挂一个展览ID字段。这个关系想错了后面所有统计都会出问题。第二条是导览路线链路观众选择一条推荐路线系统按展厅顺序返回展品序列提供当前展品和下一个展品的切换。这是导览系统区别于普通信息展示系统的核心功能。观众不是自己在展品列表里乱翻而是跟着系统推荐的顺序走。第三条是预约参观链路选择日期和场次提交预约后端校验当天名额是否满、用户是否重复预约。这个功能牵扯到日期统计和唯一约束属于既简单又容易出细节问题的地方。2.3 后台功能的核心不在CRUD后台的展览管理和展品管理工作量最大但我真正想强调的不是基础的增删改查而是两个容易被低估的模块图片集上传。展品管理不是传一张图就完事要支持多图上传主图加细节图还要做格式和大小限制。很多毕设项目图片传上去要么显示不出来要么上传失败没提示原因就是没做校验和资源映射。导览路线编排。导览员在后台重新排序某个展览下的展品顺序保存后这个顺序就是观众端看到的推荐路线。我的实现方式是在展览和展品的关联表上加一个display_order字段而不是单独建一张路线表。单个展览的默认导览顺序和展品的展示顺序本质上是一回事没必要把简单问题复杂化。只有当你需要同时支持精品速览路线和全面深度路线多条路线时才值得拆成独立路线表结构。3. 数据表设计与关系取舍展览、展品、路线怎么不绕弯3.1 核心表结构清单数据模型是整棵树的根根上出问题枝叶再茂盛也长不好。我整理一下最终落到MySQL里的核心表user用户表。字段有用户名、密码BCrypt加密后存储、角色、昵称、头像、手机号。exhibition展览表。字段有标题、简介、封面图、开始时间、结束时间、状态、每日预约上限。artwork展品表。字段有名称、作者、年代、材质、尺寸、简介、详细介绍、封面图。exhibition_artwork展览展品关联表。字段有展览ID、展品ID、display_order。category分类表以及artwork_category关联表用于展品按风格或题材分类。reservation预约表。字段有用户ID、展览ID、预约日期、场次、状态。collection收藏表。字段有用户ID、展品ID、收藏时间。comment评论表。字段有用户ID、展品ID、内容、审核状态、评论时间。整体关系并不复杂但有三处设计我花了不少心思多说几句。3.2 为什么我不单独建导览路线表这是我被问得最多的设计决策。先解释一下如果建一张独立的路线表结构通常是route路线ID、路线名称、route_item路线ID、展品ID、排序号然后再关联展览。听上去很正规但在每个展览只推荐一条默认路线的场景下这纯属多此一举。展品挂在展览下本身就有顺序。导览员推荐的默认路线就是展品的展示顺序。直接在exhibition_artwork上增加display_order用一条SQL就能把整个路线查出来。SELECT a.*, ea.display_order FROM exhibition_artwork ea LEFT JOIN artwork a ON ea.artwork_id a.id WHERE ea.exhibition_id #{exhibitionId} ORDER BY ea.display_order ASC, a.id ASC;注意我排序时加了a.id ASC作为第二条件。因为如果两个展品恰好排了相同的display_order还需要一个稳定的兜底顺序不然刷新一次页面顺序就变了——这个细节在答辩时提出来比单纯列出表结构更能体现工程意识。3.3 display_order的步长设计这个细节在实操层面特别有用。如果你把display_order的值设成1、2、3这样连续递增那么当导览员想把一件新展品插到第2和第3件之间时你得先把第3件开始的所有展品整体往后挪。这操作在后台实现时又要写循环又要开事务容易出问题。我的做法是初始化时按步长10递增10、20、30、40。这样插入时只需要把新展品的display_order设为15排序立刻生效不用动其他记录。这个思路其实就是线性表插入操作里的预留间隙策略类似的场景在排序需求里很常见值得记下来。3.4 预约余量表的逻辑预约功能我用了每日统计表加前端按钮置灰的组合方案。单独建一张reservation_date_count表字段展览ID、预约日期、已约人数。用户在预约时后端先查这张表判断当天已约人数是否达到展览表的daily_limit上限。没满就插入预约记录同时把统计表的已约人数加一。这个方案在毕设场景下完全够用。它存在的并发问题很明确两个人同时点预约可能都读到还有名额然后都插入成功导致超约。如果答辩时被问到这个问题你就说可以通过对日期加唯一索引、使用数据库行级锁或乐观锁来优化然后顺带提一句高并发场景也可以引入Redis预扣库存。这样既承认了设计边界也展示了扩展思路。4. 核心链路实现细节从登录到推荐路线的完整串联4.1 JWT鉴权与Spring Security的配合登录认证我选的是Spring Security JWT的组合。很多同学一听Spring Security就觉得重实际上毕设项目里只用得上它的过滤器链和注解权限并没有想象中那么复杂。整体流程是这样的登录接口接收用户名密码校验通过后用JWT生成工具生成token返回前端前端把token存到本地存储在axios拦截器里统一给每个请求加上Authorization请求头后端写一个JWT过滤器从每个请求头里解析token把用户ID和角色塞进Spring Security的上下文需要保护的后台接口用PreAuthorize(hasRole(ADMIN))之类的注解控制访问。JWT过滤器的核心逻辑大概长这样public class JwtAuthenticationFilter extends OncePerRequestFilter { Override protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain) throws ServletException, IOException { String token request.getHeader(Authorization); if (token ! null token.startsWith(Bearer )) { Claims claims JwtUtil.parseToken(token.substring(7)); if (claims ! null) { ListGrantedAuthority authorities List.of( new SimpleGrantedAuthority(claims.get(role, String.class)) ); UsernamePasswordAuthenticationToken authentication new UsernamePasswordAuthenticationToken( claims.getSubject(), null, authorities); SecurityContextHolder.getContext().setAuthentication(authentication); } } filterChain.doFilter(request, response); } }这里有一个特别容易踩的坑需要把Spring Security的csrf关闭否则POST请求会全部401。我一开始没关折腾了大半天。为什么登录接口单独测试是通的一接前端就报无效会话——查到最后就是这个原因。4.2 展览状态的自动切换思路展览有未开始进行中已结束三种状态。最容易想到的方案是后台维护一个状态字段然后用定时任务每天去更新。但这里有个更轻量的做法不存状态查询时用当前时间动态判断。每次查询展览列表时用当前时间跟start_time、end_time比较LocalDateTime now LocalDateTime.now(); QueryWrapperExhibition wrapper new QueryWrapper(); // 进行中的展览开始时间早于当前时间、结束时间晚于当前时间 wrapper.le(start_time, now).ge(end_time, now);这样做的好处很明显不会出现定时任务挂了导致状态没更新的情况坏处是每次查询都要算一遍但毕设量级的并发根本没压力。前端列表页可以分别查进行中和即将开始两个Tab只要把查询条件换一下就行。如果你论文里要写状态自动流转完全可以把动态计算状态作为核心思路写进去。4.3 导览路线接口的返回结构路线接口的设计我保持简单按展览ID查展品列表一次查完整前端用数组索引来控制上一个/下一个切换不需要频繁请求后端。GetMapping(/guide/{exhibitionId}) public RListArtworkVO guideRoute(PathVariable Integer exhibitionId) { ListArtworkVO artworks artworkMapper.selectArtworksByExhibitionOrderBySort(exhibitionId); return R.ok(artworks); }前端拿到这个列表后观众点了开始导览就进入一个全屏的导览模式页面顶部是展品大图中间是展品信息底部是两个按钮上一个、下一个。到了最后一个展品时弹出一个导览结束的提示这个产品逻辑虽然简单但很贴合线下观展的动线。4.4 图片上传与本地资源映射展品和展览的封面图上传我用的是本地磁盘存储加静态资源映射方案。优点是不依赖外部服务演示和答辩时不会因为云服务过期导致图片全挂。application.yml里配置spring: web: resources: static-locations: file:${user.dir}/upload/再写一个配置类补一层映射Configuration public class WebConfig implements WebMvcConfigurer { Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/upload/**) .addResourceLocations(file:/// System.getProperty(user.dir) /upload/); } }上传接口里做两层校验文件大小不超过5MB扩展名限定jpg、png、webp。大小校验用file.getSize()格式就用文件扩展名判断。这里提醒一句扩展名判断只是最基础的校验生产环境还应该校验文件的实际MIME类型防止有人把脚本文件伪装成图片上传。4.5 评论的唯一性和审核状态评论模块没有太多花活但审核状态是必须有的一环。我在评论表上加了status字段0待审核、1已通过、2已驳回。前台查询时只查status1的评论后台给导览员开放审核入口。这里有个交互细节值得注意用户提交评论成功后不应该立刻出现在评论列表里文案要提示评论已提交审核通过后展示。如果前端直接展示用户看到自己的评论明明显示出来了后台状态却还是待审核就会产生困惑。小细节但能看出做产品的脑子清不清楚。5. 前后端联调踩坑记录图片404、跨域、分页失效的根因5.1 图片上传后前端访问404这是我调试过程中花时间最久的一个问题。上传接口返回/upload/xxx.jpg前端模板里直接拼上这个地址访问但浏览器显示404。一开始我以为是路径拼接问题检查了半天才发现是资源映射的锅。addResourceLocations的路径末尾必须带斜杠而且本地路径建议写成file:///带三个斜杠的形式才可以正确解析盘符。写成file:${user.dir}/upload/在某些Windows环境下会解析异常。如果你也遇到图片404优先检查这两点registry.addResourceHandler(/upload/**) .addResourceLocations(file:/// System.getProperty(user.dir) /upload/);5.2 跨域配置的经典大坑前后端分离部署在本地时后端8080端口前端Vite默认5173端口请求必然产生跨域。我早期配置跨域时踩了一个Spring框架特有的坑开了allowCredentials(true)之后allowedOrigins里不允许用*通配符否则运行时报When allowCredentials is true, allowedOrigins cannot contain the special value *正确做法是用allowedOriginPatterns(*)Bean public CorsFilter corsFilter() { CorsConfiguration config new CorsConfiguration(); config.addAllowedOriginPattern(*); config.addAllowedMethod(*); config.addAllowedHeader(*); config.setAllowCredentials(true); UrlBasedCorsConfigurationSource source new UrlBasedCorsConfigurationSource(); source.registerCorsConfiguration(/**, config); return new CorsFilter(source); }5.3 MyBatis Plus分页插件失效的真相列表页分页是很常见的需求我用的是MyBatis Plus的Page对象。但我第一次写完测试时发现返回的总条数是正确的数据却是全量的——分页根本没生效。原因很简单没有注册分页插件。Spring Boot下需要显式注入MybatisPlusInterceptor并添加PaginationInnerInterceptorBean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; }还有一个隐蔽的坑Page对象在Mapper方法参数里的位置有讲究。MyBatis Plus约定Page必须是第一个参数如果你把它放在后面插件不会拦截分页自然失效。这个坑网上讨论很多但自己踩一遍印象才深。5.4 跨天日期和时区问题的排查在做预约功能时前端传了一个日期字符串2025-06-01到后端后端用LocalDate.parse解析再查统计表一切正常。但有个奇怪的现象如果预约日期是当天Liunx服务器上测试总是报日期已过期。排查发现是服务器时区和本机时区不一致LocalDate.now()在服务器上拿到的是UTC日期比北京时间早8个小时导致当天22点之后提交预约后端已经认为是第二天了。最终在application.yml里显式设置了时区spring: jackson: time-zone: GMT8同时数据库连接串里也加了serverTimezoneAsia/Shanghai。这个问题在本地Windows上可能完全复现不出来但放到服务器上一定炸属于本地好好的一部署就抽风的经典案例。6. 演示准备与答辩应对把源码讲成自己的项目6.1 演示数据要舍得花时间造我见过太多人功能都写完了但演示时页面上空荡荡的效果极差。答辩老师不会因为你的后台管理功能强大就脑补出一堆展品他看到的就是界面上的实际内容。我的建议是功能开发完之后专门花一个晚上准备演示数据录入至少4个展览覆盖进行中和即将开始两种状态每个展览关联8到12件展品展品要有清晰的图片、完整的基础信息作者、年代、材质、尺寸设计两条顺序明显不同的导览路线用来展示拖拽排序的效果差异制造几笔预约记录让后台的预约统计图表有数据可看。图片素材用免费图库或者自己拍的照片都行但有一个硬性要求图片必须全部使用本地资源不能依赖外链。现场演示时一旦联网状态不好外链图片集体加载失败页面就是一堆破图体验极差。6.2 答辩时的几个高频追问与回答思路根据我实际参与评审和答辩的经验这个项目最容易被追问的问题基本就这几个问题一展览和展品的关系为什么是多对多回答思路同一件展品可能被借调到不同的特展中也可能随巡展在不同场馆之间流动。如果展品表直接挂一个展览ID那么一个展品只能属于一个展览这与实际业务不符。所以用中间关联表来维护多对多关系同时可以顺便往里扩展排序字段。问题二导览推荐顺序是怎么设计的回答思路导览员在后台对展览内的展品进行拖拽排序排序结果存在关联表的display_order字段上。前台查询时按该字段升序返回就形成了一条完整的导览路线。如果以后要支持多条路线再引入独立路线表的扩展方案。问题三预约功能怎么防止超卖回答思路当前实现采用每日预约统计表在提交预约前校验当天余量。并发量上来后有几种优化方向——给用户和日期加唯一索引防止重复预约用数据库行锁或乐观锁控制并发扣减或者用Redis预扣库存。这个回答既承认了现有方案的边界又给出了可行的演进路径。问题四图片文件存在本地如果部署到线上怎么保证不丢回答思路当前项目阶段的图片存储在本地磁盘适配了开发和演示场景。生产部署时可以接入对象存储服务把上传接口的存储逻辑抽象成接口层上传到云存储同时通过CDN加速访问。这样在架构上做到了可替换不影响业务代码。6.3 从完成到交付的最后一公里整套系统做完之后我还有一个很深的体会演示通顺不等于交付可用。比如后台录入展品时十几个字段逐个输入很容易让人心烦导览员没有动力维护内容系统慢慢就会变成空壳。我后来在后台做了一个批量录入的辅助功能并且给常用字段都设置了合理的默认值。如果你打算把这套系统继续扩展我最推荐优先做两件事第一个是Excel导入展品。让导览员提前维护好一张表一键导入后台效率比逐个录入高一个量级。第二个是扫码导览入口。给每件展品生成对应的二维码观众在线下看到展签上的二维码扫一下直接进入展品详情页这一步把线上系统和线下观展动线真正打通了整个项目的完成度会立刻上一个台阶。做毕业设计最后都会明白一个道理技术难点只是其中一环更大的工作量在实际落地时才会浮现。这个项目让我从实现了一个功能进阶到完成了一个可用系统这个跨越我个人觉得比任何单个技术的掌握都更有价值。