用 Spring Boot 静态资源映射 vs 用 Nginx 提供静态文件服务总结

【1】Spring Boot 静态资源映射 vs 用 Nginx 提供静态文件服务

✅ 简短回答：

在性能、并发能力、缓存控制、安全性等方面，Nginx 完胜。

所以：如果你只是提供静态文件下载（如图片、PDF、Excel 等），强烈推荐使用 Nginx；如果需要权限校验、日志记录等业务逻辑，再考虑 Spring Boot。

---

🧠 一、两种方案的详细对比

对比维度	Spring Boot ResourceHandler	Nginx location + alias
⚡ 性能	较低，受限于 JVM 和线程池	极高，专为高性能设计
🔁 并发支持	中等，受线程数限制	高，并发能力强
📦 文件大小支持	小到中等（需流式处理）	支持大文件，支持 Range 请求
🧼 权限控制	✅ 可做鉴权、Token 校验	❌ 原生不支持，需配合 Lua/脚本
🧩 缓存控制	可配置，但较麻烦	✅ 易配置（Cache-Control、Expires）
📡 CDN 加速	❌ 不易集成	✅ 天然适合
💾 日志记录	✅ 可记录访问日志、用户信息	❌ 默认只记录 IP，无业务上下文
🛠️ 配置复杂度	简单	中等
🔄 维护成本	低	略高（需运维 Nginx）

---

📈 二、性能对比（典型场景）

场景 A：小文件（<1MB），并发不高

• ✅ 两者都可用
• 推荐：Spring Boot（开发简单）

场景 B：中大文件（>5MB），并发高

• ✅ Nginx 更优（支持断点续传、高效 IO）
• ❌ Spring Boot 容易导致内存压力或响应慢

场景 C：带权限控制的私有文件

• ✅ Spring Boot（可结合 Token、Session、JWT）
• ❌ Nginx 原生不支持，需 Lua 模块或反向代理

场景 D：公开文件，频繁访问

• ✅ Nginx（+ CDN）更合适
• ❌ Spring Boot 效率低，浪费后端资源

---

🧱 三、架构建议（推荐组合方式）

你可以采用 混合架构，兼顾安全与性能：

前端请求 --> Nginx（静态文件） or Spring Boot（带权限的文件）

示例：

✅ 公共文件走 Nginx：

location /study/file/download/ {
    alias /data/files/public/;
    add_header Accept-Ranges bytes;
    expires 7d;
    add_header Cache-Control "public";
}

访问：

http://yourdomain.com/study/file/download/abc.png

✅ 私有文件走 Spring Boot：

@GetMapping("/file/private/{id}")
public void downloadPrivateFile(@PathVariable String id, HttpServletResponse response) {
    // 鉴权逻辑
    // 流式返回文件
}

访问：

http://yourdomain.com/file/private/abc123.png

---

🛠️ 四、Nginx 配置示例（完整推荐版）

location /study/file/download/ {
    alias /data/files/public/;

    # 支持断点续传
    add_header Accept-Ranges bytes;

    # 缓存策略（7天）
    expires 7d;
    add_header Cache-Control "public";

    # 防盗链（可选）
    valid_referers none blocked yourdomain.com *.yourdomain.com;
    if ($invalid_referer) {
        return 403;
    }
}

---

🧪 五、如何测试哪个更快？

你可以使用以下工具快速测试：

1. Chrome DevTools → Network 查看加载时间

指标	说明
Waiting (TTFB)	后端处理速度
Receiving	下载速度

2. 使用 curl 命令行测试

time curl -o /dev/null http://localhost:8080/file/xxx.png   # Spring Boot
time curl -o /dev/null http://localhost/study/file/download/xxx.png   # Nginx

---

💡 六、结论总结

场景	推荐方案
公共文件、频繁访问、大并发	✅ Nginx
私有文件、需要鉴权、审计日志	✅ Spring Boot
需要 CDN 加速、跨区域访问	✅ Nginx + CDN
开发调试阶段、并发不大	✅ Spring Boot
混合场景（公有+私有）	✅ 推荐组合使用

---

💬 最佳实践建议

如果你现在是：

• 初期项目 ➜ 用 Spring Boot 快速搭建
• 上线后流量变大 ➜ 把公共文件迁移到 Nginx 或对象存储（OSS/COS/S3）
• 有权限控制需求 ➜ 在 Spring Boot 中实现私有文件下载接口

---

【2】Nginx 如何实现防盗链和缓存控制？

✅ 一、Nginx 实现防盗链（防止外部网站盗用你的资源）

🎯 目标：

防止其他网站通过 <img src="http://yourdomain.com/xxx.jpg"> 的方式引用你的图片或资源。

✅ 实现方法：使用 valid_referers 指令

🔐 示例配置：

location ~ \.(gif|jpg|jpeg|png|css|js|ico|mp4|pdf)$ {
    # 允许的 Referer 列表
    valid_referers none blocked yourdomain.com *.yourdomain.com;

    # 如果 $invalid_referer 不为 0（即非法来源），返回 403
    if ($invalid_referer) {
        return 403;
    }

    # 缓存控制（后面讲）
    expires 7d;
    add_header Cache-Control "public";
}

---

🔍 参数说明：

参数	含义
none	允许无 Referer 请求访问
blocked	允许被防火墙或代理屏蔽了 Referer 的请求
yourdomain.com	允许自己的域名访问
*.yourdomain.com	支持子域名

---

🧪 测试方法：

1. 在第三方网页中写：

   <img src="http://yourdomain.com/images/test.png" />

2. 如果 Nginx 配置生效，浏览器会显示 403 Forbidden（无法加载）

---

✅ 二、Nginx 实现缓存控制（提升性能）

🎯 目标：

• 让浏览器缓存静态资源，减少重复请求
• 控制 CDN 或代理服务器是否缓存资源

✅ 实现方法：使用 expires 和 Cache-Control

🔒 示例配置：

location ~ \.(gif|jpg|jpeg|png|css|js|ico|mp4|pdf)$ {
    expires 7d;                          # 设置缓存时间为 7 天
    add_header Cache-Control "public";   # 表示该资源可以被 CDN、浏览器缓存
}

---

🧠 可选参数说明：

指令	示例值	含义
expires	7d / 24h / +30s	设置缓存过期时间（支持 s 秒、m 分钟、h 小时、d 天）
Cache-Control	public, private, no-cache, max-age=...	控制缓存行为
add_header Pragma	"public"	HTTP 1.0 兼容性设置

---

📈 推荐组合配置（含防盗链 + 缓存）：

location ~ \.(gif|jpg|jpeg|png|css|js|ico|mp4|pdf)$ {
    # 防盗链
    valid_referers none blocked yourdomain.com *.yourdomain.com;
    if ($invalid_referer) {
        return 403;
    }

    # 缓存控制
    expires 7d;
    add_header Cache-Control "public";
    add_header Pragma "public";

    # 开启高效文件传输（可选）
    sendfile on;
    tcp_nopush on;
    tcp_nodelay off;
}

---

🧪 如何测试缓存是否生效？

方法一：Chrome DevTools 查看响应头

打开开发者工具 → Network → 找到一个图片或 JS 文件 → 查看 Response Headers：

Cache-Control: public
Expires: Sat, 07 Jun 2025 12:34:56 GMT

表示缓存已生效。

方法二：curl 命令查看头信息

curl -I http://yourdomain.com/images/test.png

输出应包含：

HTTP/1.1 200 OK
Server: nginx
Content-Type: image/png
Content-Length: 123456
Expires: Sat, 07 Jun 2025 12:34:56 GMT
Cache-Control: public

---

💡 三、高级技巧（可选）

1. 使用 ETag 控制缓存刷新

默认情况下 Nginx 会自动生成 ETag，你可以关闭它：

location ~ \.(gif|jpg|jpeg|png|css|js|ico|mp4|pdf)$ {
    etag off;
}

这样浏览器就不会做 304 Not Modified 缓存校验。

---

2. 根据文件名版本控制缓存（推荐做法）

例如：

logo-v1.2.3.png

当内容更新时改名为：

logo-v1.2.4.png

这样浏览器就会重新下载新文件，避免缓存问题。

---

🧱 四、结合 CDN 使用建议

如果你用了 CDN（如阿里云 CDN、腾讯云 CDN、Cloudflare），可以在 Nginx 中加上这些配置以配合 CDN 缓存：

location ~ \.(gif|jpg|jpeg|png|css|js|ico|mp4|pdf)$ {
    expires 30d;
    add_header Cache-Control "public, max-age=2592000"; # 30天
    add_header Pragma "public";
    add_header Access-Control-Allow-Origin "*"; # 跨域访问 CDN
}

---

📌 总结对比表

功能	是否推荐启用	配置方式
防盗链	✅ 强烈推荐	valid_referers + if ($invalid_referer)
缓存控制	✅ 必须开启	expires + Cache-Control
CDN 加速	✅ 强烈推荐	配合缓存头 + 版本号文件名
ETag 控制	⚠️ 可选	etag on/off
跨域支持	⚠️ CDN 场景需要	Access-Control-Allow-Origin

---