Java头像上传应存文件系统或对象存储而非数据库BLOB，需校验大小类型、重命名防攻击、禁执行权限；本地用Nginx映射静态路径，生产推荐OSS并存key与URL，数据库仅存元信息，删除时同步清理文件。
Java项目中处理用户头像上传，核心在于安全接收文件、合理存储、高效访问。不推荐直接存数据库（BLOB），优先用文件系统或对象存储，配合唯一路径和尺寸规范。
上传接口设计与安全校验
使用 Spring Boot 的 MultipartFile 接收头像，必须做基础校验：
- 限制文件大小（如 ≤2MB），在
application.yml中配置：spring.servlet.multipart.max-file-size=2MB - 检查文件类型：只允许
image/jpeg、image/png、image/gif，别只看后缀，要读取魔数（可用javax.imageio.ImageIO或 Apache Tika） - 重命名文件：用 UUID + 用户ID + 时间戳生成唯一名，避免中文、空格、特殊字符
- 禁止执行权限：保存前确保文件不可被 Web 容器直接执行（尤其禁用
.jsp、.php等伪装图）
本地存储方案（开发/小流量适用）
适合测试或内部系统，把头像存在项目外的固定目录（如 /data/uploads/avatar/），不放在 src/main/resources 或 static 下。
- 按用户 ID 分级建目录（如
/avatar/123/456/abc.png），避免单目录文件过多 - 配置 Nginx 静态资源映射，例如：
location /avatar/ { alias /data/uploads/avatar/; } - 返回给前端的是相对 URL（如
/avatar/123/456/abc.png），由 Nginx 直接响应，不走 Java 应用
云对象存储（生产推荐）
阿里云 OSS、腾讯云 COS、AWS S3 是主流选择，兼顾扩展性、CDN 加速和可靠性。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
- Java SDK 上传时指定私有读写 + 临时签名 URL（用于前端预览或下载）
- 头像统一缩略为标准尺寸（如 100×100、200×200），可借助
Thumbnailator或 ImageMagick 处理 - 存储路径建议含业务标识和时间分片，例如：
avatar/{yyyy}/{MM}/{dd}/{userId}_{uuid}.jpg - 数据库只存 OSS 的 key（如
avatar/2024/06/15/888_xxx.jpg）和访问 URL（可选）
数据库字段与一致性保障
用户表加字段记录头像信息，但不存二进制数据：
-
avatar_key VARCHAR(255)：OSS 的 object key 或本地相对路径 -
avatar_url VARCHAR(512)：可缓存的公开 URL（可选，避免每次拼接） -
avatar_type TINYINT：0=默认头像，1=用户上传，2=第三方登录头像 - 删除用户时，同步清理对应头像文件（调用 OSS deleteObject 或本地
Files.delete()）
基本上就这些。关键不是“怎么传”，而是“传完怎么管”——路径唯一、权限可控、删得干净、查得方便。
