Java图片存储与展示需分离关注点：本地存项目外目录或对接OSS，统一UUID命名，后端多层校验文件类型/大小/扩展名，静态资源映射或直连OSS URL访问，缩略图用Thumbnailator等库处理。
Java项目中图片存储与展示的核心在于“分离关注点”：上传路径、存储位置、访问路由、缩略图生成、安全性校验要各司其职，不能混在一起硬编码。
图片存储路径设计：本地还是远程？
本地存储适合开发调试或小型系统，推荐将图片存放在 项目外部独立目录（如 /data/uploads/），避免打包进 WAR 或重启丢失。绝对不要存到 src/main/resources 或 webapp/ 下。
生产环境强烈建议对接对象存储（如阿里云 OSS、腾讯 COS、MinIO 自建）。好处是解耦服务器磁盘、天然支持 CDN、权限可控、高可用。Java SDK 调用简单，只需配置 endpoint、accessKey、bucket 即可上传并返回可公开访问的 URL。
- 本地存储：用
FileOutputStream写入 + 配置静态资源映射（如 Spring Boot 的spring.web.resources.static-locations） - OSS 存储：上传后返回外网 URL，后端不保存物理文件，只存 URL 到数据库
- 注意统一管理文件名：用 UUID + 时间戳 + 原始后缀（如
8a2b3c4d-1234-5678-90ab-cdef12345678_20240520142233.jpg），防止中文、特殊字符、重名问题
图片上传与校验：安全不能妥协
用户上传的图片本质是二进制流，必须做多层校验——前端限制只是参考，后端才是最后一道防线。
立即学习“Java免费学习笔记（深入）”；
- 检查
Content-Type（如image/jpeg）但不唯一依赖它，需读取文件头（Magic Number）验证真实类型 - 限制大小（如 ≤5MB），用
MultipartFile.getSize()提前拦截 - 校验文件扩展名白名单（
.jpg, .jpeg, .png, .webp），且与 MIME 类型、文件头三者一致 - 敏感操作建议开启防恶意文件重命名（如禁用
../、空字节、控制字符）
图片访问与展示：动静分离是关键
不要让 Spring MVC 接口去读文件再输出流（ResponseEntity），性能差还占线程。正确做法是：
- 本地存储 → 配置 WebMvcConfigurer 添加
addResourceHandlers，把上传目录映射为静态路径（如/uploads/** → file:/data/uploads/） - OSS 存储 → 直接返回预签名 URL 或公开 URL，在 HTML/JS 中用
- 需要权限控制（如私有图片）→ 用临时 token 校验后重定向到 OSS 签名 URL，或走代理接口（慎用，加缓存）
常见图片处理需求：缩略图、水印、格式转换
别手写 BufferedImage 拼接，用成熟库更稳：
- Thumbnailator：轻量、API 清晰，一行代码生成缩略图、旋转、水印
- GraphicsMagick / ImageMagick（JNI）：适合批量高压缩比处理，但需部署原生依赖
- Apache Commons Imaging：纯 Java，适合元数据读写（EXIF）、简单裁剪
- 生成缩略图建议按需触发（上传时同步生成 2~3 种尺寸），或首次访问时异步生成并缓存（避免重复计算）
基本上就这些。结构清晰了，后续加 CDN、换存储、做灰度发布都容易。不复杂但容易忽略的是：所有路径、URL、配置项尽量抽成配置文件变量，别散落在 Controller 或 Service 里。
