七层转发实现动静分离的核心是Nginx在HTTP层按URL路径、后缀或Host将静态资源(如/static/、.jpg等)本地响应,动态请求(如/api/、/user/等)反向代理至Tomcat;需精准配置location匹配优先级、upstream服务池及proxy_pass路径重写规则,并验证文件权限与日志分流。

七层转发实现动静分离,核心是让 Nginx 在 HTTP 层(应用层)根据请求的 URL 路径、后缀或 Host 等特征,把静态资源(如 CSS、JS、图片、HTML)直接由 Nginx 本地响应,而将动态请求(如 /api/、/user/login)反向代理到后端 Tomcat 或其他应用服务器。这不是简单加个 upstream 就行,关键在 location 匹配逻辑 + 静态路径处理 + 动态路由分发。
明确动静资源划分规则
先定好哪些算“静”,哪些算“动”,避免冲突:
- 静态资源通常包括:/static/、/images/、/css/、/js/、.jpg、.png、.woff2、.html(若为纯前端页面)
- 动态资源一般匹配:/api/、/admin/、/user/、/login、/do/ 等业务接口前缀,或所有未被静态规则捕获的请求(用
location / { ... }做兜底) - 注意:location 匹配有优先级,
^~和=优先于普通/xxx;带正则的~*最后匹配
配置 Nginx 实现动静分流
在 http 块中定义 upstream,并在 server 块中按路径精准分发:
- 定义后端服务池(例如 Tomcat 集群):
upstream tomcat_pool {<br> server 192.168.20.101:8080 weight=2;<br> server 192.168.20.102:8080;<br> keepalive 32;<br>} - 配置静态资源直出(不走代理):
location ^~ /static/ {<br> alias /usr/share/nginx/html/static/;<br> expires 1h;<br> add_header Cache-Control "public, immutable";<br>} - 配置动态接口代理(带头透传):
location ^~ /api/ {<br> proxy_pass http://tomcat_pool/;<br> proxy_set_header Host $host;<br> proxy_set_header X-Real-IP $remote_addr;<br> proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;<br> proxy_redirect off;<br>} - 兜底动态请求(非静态、非 API 的其他路径):
location / {<br> proxy_pass http://tomcat_pool/;<br> # 同上 proxy_set_header...<br>}
验证与避坑要点
配置完别急着 reload,重点检查这几项:
- 确保静态文件真实存在于
alias指定路径,且 Nginx 用户有读取权限(常见 403 错误来源) -
proxy_pass末尾加不加/影响路径重写:写成http://tomcat_pool/会剥离 location 前缀;写成http://tomcat_pool(无斜杠)则原样透传 - 避免 location 重叠,比如
/static和/static/css不要分别写两个普通匹配,用^~统一覆盖更安全 - 启用
log_format记录 $request_uri 和 $upstream_addr,可快速判断某次请求到底进了哪个分支
进阶补充(按需启用)
生产环境建议叠加以下优化:
- 对静态资源启用 Gzip 压缩:
gzip on; gzip_types text/css application/javascript image/svg+xml; - 为 HTML 加上 ETag 和 Last-Modified,配合浏览器缓存协商
- 用
try_files实现 SPA 路由 fallback(如 Vue/React):try_files $uri $uri/ /index.html; - 动静分离后,Tomcat 可移除静态文件目录,专注处理 Servlet 请求,降低内存与线程压力










