Nginx 中 Java 部署如何配置动静分离将静态资源交由 Nginx 处理

作者：袖梨 2026-08-27

Nginx动静分离的核心是让Nginx直接响应静态资源请求，仅将动态路径（如/api/、/login等）转发给Tomcat；需统一存放静态文件至独立目录，用location精准匹配并配置alias/root、缓存头及安全策略，禁用Tomcat静态服务以确保资源交付权移交。

Java 应用（如 Spring Boot、传统 WAR 包部署在 Tomcat）通常默认把静态资源（/static、/public、/resources 等目录下的 CSS/JS/图片）和动态接口混在一起发布。直接由 Tomcat 处理全部请求，会严重浪费线程资源。Nginx 动静分离的核心就是：让 Nginx 拦截并直接响应静态请求，只把真正需要 Java 处理的动态路径（如 /api/、/login、/*.do）转发给 Tomcat。

明确静态资源范围与存放位置

Java 项目上线前，建议将前端构建产物（如 Vue/React 打包后的 dist 目录）或后端静态资源统一提取出来，单独存放到服务器一个固定路径，例如：

/data/www/static/ —— 存放所有 CSS、JS、图片、字体、HTML 页面
/data/www/upload/ —— 存放用户上传的图片等（需额外配置权限和安全策略）

注意：不要把静态文件继续放在 Tomcat 的 webapps/ROOT/ 下，否则容易被 Nginx 和 Tomcat 同时匹配，造成冲突或绕过缓存。

用 location 精准拦截静态请求

在 Nginx 的 server 块中添加以下几类匹配规则，优先级从高到低，确保静态请求不落到 proxy_pass 分支：

按目录匹配：如访问 /static/xxx.js，直接映射到本地目录
location /static/ { alias /data/www/static/; }
按文件后缀匹配：覆盖常见前端资源类型，带缓存头
location ~* .(js|css|png|jpg|jpeg|gif|ico|svg|woff2?|ttf|eot|html)$ { root /data/www/static; expires 1y; add_header Cache-Control "public, immutable"; }
防止隐藏文件泄露：
location ~ /. { deny all; }

⚠️ 关键细节：alias 和 root 行为不同。用 alias /path/ 时，URI 中的路径名会被替换；用 root /path 时，URI 全路径会拼接到 root 后。别写反，否则 404。

只转发明确的动态路径给 Tomcat

避免使用笼统的 location / { proxy_pass http://tomcat; }，那样会覆盖所有请求，包括本该由 Nginx 处理的静态资源。

推荐方式：按前缀转发
location /api/ { proxy_pass http://127.0.0.1:8080/; }

location /admin/ { proxy_pass http://127.0.0.1:8080/; }

（注意末尾斜杠，决定是否重写路径）
或按后缀转发（适用于传统 Servlet）
location ~ .(do|action|jsp)$ { proxy_pass http://127.0.0.1:8080; }
务必透传关键请求头：
proxy_set_header Host $host;

proxy_set_header X-Real-IP $remote_addr;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

proxy_set_header X-Forwarded-Proto $scheme;

补充优化项（生产必备）

提升稳定性和安全性：

禁用 Tomcat 的静态服务：在 server.xml 中注释或删除 DefaultServlet 的映射，或设置 readonly="true"，避免意外暴露
启用 sendfile 加速文件传输：
sendfile on;

tcp_nopush on;
压缩文本资源：
gzip on;

gzip_types text/css application/javascript application/json;
限制上传大小（如需）：
client_max_body_size 10m;（放在 http 或 server 块）