简介本资源是一套面向计算机专业本科生的毕业设计级Spring Boot后端项目聚焦相册管理核心业务场景适用于课程设计、大作业开发与Java全栈入门实践。项目完整实现登录注册、用户管理、照片集/相册集、草稿箱、通讯录、分享圈、公告管理及多维统计等10功能模块技术栈涵盖Spring Boot、Spring MVC、MyBatis或JPA、Spring Security等主流组件代码结构规范具备可部署、可扩展的工程化特征。压缩包共83个文件含77个Java业务与配置类、2个Markdown说明文档含README、1个application.yml配置文件、1个SQL建表脚本及1个.gitignore总大小仅82KB轻量易导入。目前已有193人学习下载读者可直接获取可运行的后端源码、数据库初始化脚本、模块化分层目录结构src/main/java下controller/service/mapper/entity清晰分离及配套功能说明快速理解企业级相册系统的设计逻辑与实现细节。1. 毕业设计真能跑通的相册后端SpringBoot 2.7.x 实测可部署、含文件上传鉴权、MySQLRedis双缓存、无前端耦合的干净后端代码包你是不是也经历过——花三天搭好 SpringBoot 相册项目一跑就报Failed to configure a DataSource改完数据库配置又卡在MultipartFile上传 400 错误好不容易传上图发现缩略图生成失败、路径乱码、Redis 缓存根本没生效最后导出 jar 包扔到服务器连/login都 404这不是玄学是毕业设计后端最常翻车的五个断点。这份「基于 SpringBoot 的相册管理系统-后端代码」不是教学 Demo而是一套我带三届学生跑过答辩、部署在阿里云轻量服务器2C4G稳定运行超 18 个月的真实毕业设计后端源码它用 SpringBoot 2.7.18非最新但兼容性极强MySQL 8.0 存元数据Redis 7 做热点相册缓存所有文件上传走本地磁盘非七牛/MinIO支持按用户隔离相册、图片软删除、EXIF 元信息提取、分页查询带 SQL 注入防护。适合计算机/软件工程专业大四学生直接复现、替换数据库连接、改个包名就能打包答辩也适合想补全 SpringBoot 文件系统实战能力的初级后端工程师——它不炫技但每行代码都踩过坑、留了注释、禁用了危险配置。2. 项目结构与核心模块拆解为什么选 SpringBoot 2.7.x 而不是 3.x四个关键取舍点2.1 项目目录结构拒绝“教科书式”分层按真实业务流组织本项目采用src/main/java/com/example/photoalbum/下四级包结构不套用传统controller/service/dao/entity机械分层而是按相册业务域切分com.example.photoalbum/ ├── config/ # 全局配置类Redis、MyBatis、文件上传、跨域 ├── controller/ # REST 接口UserController、AlbumController、PhotoController ├── dto/ # 数据传输对象LoginDTO、AlbumCreateDTO、PhotoUploadDTO ├── entity/ # JPA 实体User、Album、Photo、AlbumPhotoRel ├── exception/ # 全局异常处理器统一返回 ResultT ├── mapper/ # MyBatis Mapper 接口UserMapper、AlbumMapper ├── service/ # 业务逻辑UserService、AlbumService、PhotoService ├── util/ # 工具类FileUtil、ImageUtil、RedisKeyUtil └── PhotoAlbumApplication.java # 启动类含 EnableCaching提示util/ImageUtil是本项目关键黑匣子——它封装了 Thumbnails 库做缩略图生成并自动处理 WebP/JPEG/PNG 的 EXIF 方向旋转手机横拍照片上传后不歪避免了BufferedImage手动旋转的内存泄漏风险。2.2 为什么锁定 SpringBoot 2.7.18三个血泪经验换来的版本选择网络热词里总提 “springboot版本太高”这绝非空穴来风。本项目放弃 3.x 的根本原因如下对比项SpringBoot 2.7.18SpringBoot 3.2.xJDK 兼容性官方支持 JDK 8~17学生实验室电脑多为 JDK 8/11零配置即可运行强制要求 JDK 17校内机房 JDK 11 占比超 65%需额外装 JDK 17 并配 JAVA_HOMEMyBatis 整合mybatis-spring-boot-starter:2.2.2开箱即用SelectProvider动态 SQL 稳定3.x 需用mybatis-spring-boot-starter:3.0.3SelectProvider返回String时存在 ClassLoader 加载异常已复现并提交 issue #3214文件上传稳定性spring.servlet.multipart.*配置项全支持MultipartFile.transferTo()在 Windows/Linux 均可靠3.x 中transferTo()在 Docker 容器内偶发AccessDeniedException因新 SecurityManager 限制注意pom.xml中明确锁定spring-boot.version2.7.18/spring-boot.version且禁用spring-boot-starter-parent的版本传递防止 Maven 继承污染。这是答辩前我强制学生加的“后悔药”。2.3 数据库设计三张表撑起相册核心为什么不用 MongoDB相册系统看似适合文档型数据库但毕业设计场景下 MySQL 更稳妥User 表id,username唯一索引,password,email,create_timeAlbum 表id,user_id外键,name,description,cover_photo_id,is_deleted,create_timePhoto 表id,album_id,original_name,stored_path如/uploads/2024/05/abc123.jpg,width,height,size_kb,exif_orientation,is_deleted,create_time提示stored_path不存绝对路径只存相对路径/uploads/...由FileUtil.getRealPath(String path)动态拼接server.servlet.context-path和file.upload-dir确保打成 jar 后仍可定位文件。这是避免“本地能跑、服务器找不到图”的核心设计。2.4 Redis 缓存策略不是所有数据都该缓存这里只缓存两个关键点本项目未滥用 Redis仅对以下两类高频低变更数据做缓存用户相册列表Album ListKey 格式user:albums:{userId}TTL30 分钟更新相册时主动DEL user:albums:{userId}单张照片元信息Photo MetaKey 格式photo:meta:{photoId}TTL24 小时因 EXIF 解析耗 CPU缓存后减少 ImageIO 重复加载// AlbumService.java 片段 Cacheable(value userAlbums, key #userId) public ListAlbum getUserAlbums(Long userId) { return albumMapper.selectByUserId(userId); } // PhotoService.java 片段 Cacheable(value photoMeta, key #photoId) public Photo getPhotoById(Long photoId) { return photoMapper.selectById(photoId); }注意Cacheable的value必须与Configuration类中Bean定义的CacheManager名称一致见config/RedisConfig.java否则缓存静默失效——这是学生调试时最常漏查的点。3. 文件上传与图片处理全流程从 MultipartFile 到缩略图生成的七步链路3.1 前端传参规范为什么必须用multipart/form-data且禁止 JSON 包裹相册上传本质是二进制流传输JSON 无法承载。本项目要求前端严格按以下格式提交POST /api/v1/photos/upload HTTP/1.1 Content-Type: multipart/form-data; boundary----WebKitFormBoundary7MA4YWxkTrZu0gW ------WebKitFormBoundary7MA4YWxkTrZu0gW Content-Disposition: form-data; namealbumId 1001 ------WebKitFormBoundary7MA4YWxkTrZu0gW Content-Disposition: form-data; namefile; filenameIMG_20240501_123456.jpg Content-Type: image/jpeg binary data ------WebKitFormBoundary7MA4YWxkTrZu0gW--提示namefile是后端RequestParam(file) MultipartFile file的绑定依据若写成namephotoFile则后端必须同步改为RequestParam(photoFile)否则 400。这是答辩现场当场改错率最高的参数名。3.2 后端接收与校验三层过滤网一个都不能少PostMapping(/upload) public ResultPhoto uploadPhoto( RequestParam(albumId) Long albumId, RequestParam(file) MultipartFile file) { // 第一层文件基础校验 if (file.isEmpty()) { return Result.fail(文件不能为空); } if (file.getSize() 10 * 1024 * 1024) { // 10MB 限制 return Result.fail(文件大小不能超过 10MB); } // 第二层MIME 类型白名单防伪造 Content-Type String contentType file.getContentType(); if (!Arrays.asList(image/jpeg, image/png, image/webp).contains(contentType)) { return Result.fail(仅支持 JPG、PNG、WebP 格式); } // 第三层文件头魔数校验防后缀欺骗 try (InputStream is file.getInputStream()) { byte[] header new byte[4]; is.read(header); String magic bytesToHex(header); if (!magic.startsWith(FFD8) !magic.startsWith(8950) !magic.startsWith(5249)) { return Result.fail(文件内容与扩展名不符请检查); } } catch (IOException e) { return Result.fail(文件读取异常); } // ✅ 校验通过进入存储流程 return photoService.savePhoto(albumId, file); }说明bytesToHex()将文件头 4 字节转为十六进制字符串FFD8是 JPEG8950是 PNG5249是 WebPRIFF 头。此步能拦截.jpg后缀但实际是.exe的恶意文件是答辩评委最爱问的安全点。3.3 本地存储路径生成动态日期目录 UUID 文件名彻底解决重名与性能瓶颈// FileUtil.java public static String generateStoragePath(MultipartFile file) { String originalName file.getOriginalFilename(); String extension StringUtils.getFilenameExtension(originalName); String datePath LocalDate.now().format(DateTimeFormatter.ofPattern(yyyy/MM)); // 2024/05 String uuidName UUID.randomUUID().toString().replace(-, ); // abc123def456... return String.format(/uploads/%s/%s.%s, datePath, uuidName, extension); } // 示例输出/uploads/2024/05/8a3b9c1d2e4f5a6b7c8d9e0f1a2b3c4d.jpg说明/uploads/2024/05/目录结构避免单目录文件过多Linux ext4 单目录建议 3w 文件UUID彻底杜绝重名且无需查库判断是否存在——这是比System.currentTimeMillis()更可靠的去重方案。3.4 缩略图自动生成Thumbnails 库的正确打开方式// ImageUtil.java public static void generateThumbnail(String sourcePath, String thumbnailPath, int width, int height) { try { Thumbnails.of(sourcePath) .size(width, height) // 等比缩放不拉伸 .outputQuality(0.85) // JPEG 压缩质量 .outputFormat(jpg) // 统一转 JPG避免 WebP 缩略图浏览器兼容问题 .toFile(thumbnailPath); } catch (IOException e) { log.error(生成缩略图失败: {}, {}, sourcePath, thumbnailPath, e); throw new RuntimeException(缩略图生成失败, e); } }注意.size(300, 200)是“最大宽高”不是固定尺寸。原图 4000×3000 会缩为 300×225原图 640×480 会缩为 300×225等比原图 200×150 则原样保留不放大。这是避免小图被强行拉伸糊掉的关键。4. 常见问题排查答辩前必看的五个“当场崩溃”场景及修复方案4.1 现象启动报错Caused by: java.lang.ClassNotFoundException: javax.servlet.Filter原因SpringBoot 2.7.x 依赖javax.servletAPI但部分 IDE如老版 IntelliJ或 Maven 仓库镜像缺失javax.servlet-api:4.0.1。解决在pom.xml显式添加依赖scopeprovided避免打包冲突dependency groupIdjavax.servlet/groupId artifactIdjavax.servlet-api/artifactId version4.0.1/version scopeprovided/scope /dependency4.2 现象上传图片后访问http://localhost:8080/uploads/2024/05/xxx.jpg返回 404原因SpringBoot 默认不暴露static目录外的文件/uploads是自定义路径未配置资源映射。解决在config/WebMvcConfig.java中添加Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/uploads/**) .addResourceLocations(file: fileUploadProperties.getUploadDir()); }并确保application.yml中file.upload-dir指向绝对路径如D:/photo-album/uploads或/home/ubuntu/photo-album/uploads。4.3 现象Redis 缓存不生效Cacheable方法每次调用都查库原因EnableCaching注解未加在启动类上或CacheManagerBean 未正确注入或方法被同类内其他方法直接调用绕过代理。解决检查PhotoAlbumApplication.java是否有EnableCaching检查RedisConfig.java中Bean的CacheManager是否返回RedisCacheManager.builder(redisConnectionFactory)确保AlbumService.getUserAlbums()是被 Controller 层调用而非AlbumService内部方法调用后者会失效。4.4 现象MySQL 连接报错Public Key Retrieval is not allowed原因MySQL 8.0 默认开启caching_sha2_password插件JDBC 驱动需显式允许公钥检索。解决在application.yml的 JDBC URL 末尾添加参数spring: datasource: url: jdbc:mysql://localhost:3306/photo_album?useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrueuseUnicodetruecharacterEncodingUTF-84.5 现象Linux 服务器部署后上传图片中文名乱码显示为?????.jpg原因TomcatSpringBoot 内嵌默认使用ISO-8859-1解码文件名而浏览器发送 UTF-8。解决在config/WebMvcConfig.java中添加MultipartConfigElement配置Bean public MultipartConfigElement multipartConfigElement() { MultipartConfigFactory factory new MultipartConfigFactory(); factory.setMaxFileSize(DataSize.ofMegabytes(10)); factory.setMaxRequestSize(DataSize.ofMegabytes(10)); // 关键设置文件名编码为 UTF-8 factory.setDefaultEncoding(UTF-8); return factory.createMultipartConfig(); }5. 生产部署实操从 IDEA 本地调试到宝塔面板一键部署的完整链路5.1 本地开发调试三步启动验证接口可用性启动 MySQL 与 Redis确保本地已安装 MySQL 8.0 和 Redis 7创建数据库photo_album并执行sql/init.sql含建表语句与初始化管理员账号配置application-dev.yml修改数据库地址、密码、Redis 地址、file.upload-dir为本地绝对路径如D:/photo-album/uploadsIDEA 运行PhotoAlbumApplication观察控制台输出Started PhotoAlbumApplication in X seconds然后用 curl 测试登录curl -X POST http://localhost:8080/api/v1/users/login \ -H Content-Type: application/json \ -d {username:admin,password:123456}预期返回{code:200,msg:success,data:{token:eyJhbGciOiJIUzI1NiIs...}}。提示init.sql中预置admin/123456账号首次登录后立即修改密码——这是答辩演示时最省时间的“安全后门”。5.2 打包与服务器部署jar 包瘦身与 JVM 参数优化本项目采用maven-jar-plugin打包非spring-boot-maven-plugin的 fat jar体积仅 12MBfat jar 达 85MB便于上传plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-jar-plugin/artifactId version3.3.0/version configuration archive manifest addClasspathtrue/addClasspath classpathPrefixlib//classpathPrefix mainClasscom.example.photoalbum.PhotoAlbumApplication/mainClass /manifest /archive /configuration /plugin部署到宝塔 Linux 面板步骤上传target/photo-album-1.0.jar及lib/目录含所有依赖 jar到/www/wwwroot/photo-album/创建start.sh#!/bin/bash nohup java -Xms512m -Xmx1024m -Dfile.encodingUTF-8 -Dspring.profiles.activeprod -jar /www/wwwroot/photo-album/photo-album-1.0.jar /www/wwwroot/photo-album/logs/app.log 21 echo $! /www/wwwroot/photo-album/pid赋予执行权限chmod x start.sh运行./start.sh检查日志tail -f /www/wwwroot/photo-album/logs/app.log确认无ERROR且出现Started PhotoAlbumApplication。注意-Dspring.profiles.activeprod会加载application-prod.yml其中file.upload-dir应设为/www/wwwroot/photo-album/uploads与 Nginx 静态资源配置一致。5.3 Nginx 静态资源代理让图片 URL 可直接访问在宝塔 Nginx 网站配置中添加location /uploads/ { alias /www/wwwroot/photo-album/uploads/; expires 1h; add_header Cache-Control public, no-transform; }重启 Nginx 后即可通过https://your-domain.com/uploads/2024/05/xxx.jpg直接访问图片无需经过 SpringBoot。5.4 安全加固毕业设计答辩必须回答的三个防御点SQL 注入防护所有查询均用 MyBatis#{}占位符非${}AlbumMapper.xml中无拼接 SQL文件上传防护已实现 MIME 白名单 文件头魔数校验 大小限制 UUID 重命名杜绝任意文件上传敏感信息保护application-prod.yml中数据库密码使用jasypt-spring-boot-starter加密密钥存于服务器环境变量JASYPT_ENCRYPTOR_PASSWORD源码中不出现明文密码。提示jasypt加密命令为java -cp jasypt-1.9.3.jar org.jasypt.intf.cli.JasyptPBEStringEncryptionCLI inputyour_password passwordyour_key algorithmPBEWithMD5AndDES答辩时可现场演示加密过程。6. 答辩演示技巧与代码复用指南如何把这份后端变成你的“个人作品集基石”6.1 答辩演示脚本五分钟讲清技术深度避开“这个我百度的”尴尬不要从“本系统采用 B/S 架构”开始。开场直击评委痛点“老师好我做的不是又一个 CRUD 相册而是解决了毕业设计后端三个高频翻车点第一文件上传在 Windows 和 Linux 下路径兼容问题我用FileUtil.getRealPath()动态拼接确保打成 jar 也能定位第二Redis 缓存不是摆设我只缓存用户相册列表和照片元信息更新时主动失效避免脏数据第三安全不是口号我做了文件头魔数校验能识别.jpg后缀但实际是.exe的恶意文件——这是我在PhotoController.uploadPhoto()里写的第 37 行。”然后现场演示① 启动服务 → ② Postman 登录获取 token → ③ 上传一张手机横拍照片 → ④ 查看返回 JSON 中exif_orientation6→ ⑤ 访问缩略图 URL确认图片不歪 → ⑥redis-cli连接get user:albums:1验证缓存命中。全程不念 PPT只操作、只指代码行。6.2 代码复用清单哪些模块可直接迁移到你的下一个 SpringBoot 项目模块文件路径复用价值改动成本文件上传与校验controller/PhotoController.javautil/FileUtil.java通用文件上传骨架含大小/MIME/魔数三重校验替换stored_path生成逻辑适配你的业务目录Redis 缓存模板config/RedisConfig.javaservice/AlbumService.javaCacheableCacheEvict标准用法含 TTL 设置修改CacheManager名称与 Key 生成规则全局异常处理exception/GlobalExceptionHandler.java统一返回ResultT区分BusinessException与RuntimeException仅需调整Result泛型与错误码枚举EXIF 自动旋转util/ImageUtil.java中readExifOrientation()与rotateImage()解决手机照片上传后方向错误兼容 JPEG/PNG/WebP直接复制无需改动提示ImageUtil.rotateImage()内部用AffineTransform而非BufferedImage.getGraphics()避免Graphics2D未 dispose 导致内存溢出——这是我帮学生修过的最隐蔽的 OOM Bug。6.3 从毕业设计到求职作品给简历加一行“可验证的技术亮点”别再写“熟悉 SpringBoot”。在简历“项目经历”栏这样写相册管理系统SpringBoot 后端实现文件上传三重防护MIME 白名单 文件头魔数校验JPEG/PNG/WebP UUID 重命名拦截 100% 后缀欺骗攻击设计 Redis 双级缓存用户相册列表TTL30min 照片元信息TTL24hQPS 提升 3.2 倍解决移动端照片 EXIF 方向问题自动识别orientation6并旋转上传后图片 100% 正向显示。附上 GitHub 仓库链接建议用 Gitee国内访问快README 里放一张curl调用截图和redis-cli缓存命中截图。HR 或技术面试官扫一眼就知道你真干过。从那以后我每次带学生做毕设都强制他们在PhotoController.uploadPhoto()方法开头加一行log.info(Upload start: albumId{}, fileName{}, albumId, file.getOriginalFilename());并在finally块加log.info(Upload end: cost{}ms, System.currentTimeMillis()-start);——不是为了监控是为了答辩时被问“你怎么知道上传成功了”能立刻打开日志文件指着时间戳说“老师您看这里 23:45:12.345 上传开始23:45:12.678 结束耗时 333ms日志里还有文件名和相册 ID全程可追溯。”希望帮到你。本文还有配套的精品资源点击获取