上个月我接手一个Java服务,线上接口时不时超时,部署的机器CPU经常飙到80%以上,查看堆栈全是Tomcat线程在等待。排查到最后一拍大腿——这台服务直接以8080端口对外,连一层Nginx都没有。做Java这么多年,我见过太多同样的情况:代理转发这件事,配置Nginx不是可选项,而是基本功。这篇文章我就把自己实战中用到的Nginx代理转发配置、踩过的坑、排查思路完整梳理一遍,从最小配置到集群负载,从前后端分离到高频故障,一次性讲透。
1. Java服务裸奔的代价:为什么代理转发是基本功
1.1 线程模型差异:Java应用被连接拖垮的过程
先讲个很多Java开发者忽略的基础问题:Tomcat这类Servlet容器和高性能代理服务器处理连接的模型完全不同。Tomcat默认采用线程池模型,一次HTTP连接在业务处理期间基本占用一个线程。当并发连接数超过线程池上限,请求要么排队等待,要么直接拒绝。更麻烦的是,如果某个接口响应很慢,线程池会被占满,后续所有请求都进不来,表现为服务"假死"。
我自己经历过一次典型的故障:一个内部系统没有接Nginx,前端页面直接把请求打到Tomcat,同时还有一堆爬虫在扫端口。高峰期连接数冲到两三千,Tomcat线程池瞬间打满,CPU上下文切换飙高,所有页面加载都变成转圈。当时第一反应是加机器,后来加了Nginx才发现,静态资源和恶意请求根本不该进Java应用。
Nginx基于事件驱动和epoll模型,单进程就能维护数万连接,处理静态资源更是强项。它就像一个非常高效的前台接待员:一个前台同时能应对几百个访客,按顺序分发到后面干活的工位。Java的线程池模型则是"每个客人配一个专职服务员",遇到大型活动就直接人手不够。所以把Nginx挡在前面,本质上是把连接管理和分发这些"轻活"从Java应用里剥离出去,让JVM专心执行业务逻辑。
注意:这里不是说Tomcat可以无脑调大线程池。线程越多,上下文切换开销越大,JVM内存占用也越高。正确的做法是让Nginx做第一层分流,合理控制后端Java的并发水位。
1.2 Nginx在Java架构里到底替你挡了什么
结合我日常维护的Spring Boot项目,Nginx代理转发带来的收益至少有这几块:
- 静态资源剥离:图片、CSS、JS这些文件由Nginx直接返回,不占Java线程。Spring Boot打出来的jar包里虽然能放静态资源,但性能和Nginx完全不在一个量级。
- 统一入口和端口收敛:所有域名、证书、路由都在Nginx统一收口,Java服务监听内网端口,不直接暴露公网,减少被扫描攻击的面。
- 多实例调度基础:后面接多个Java服务实例时,Nginx负载均衡承担了流量分发角色,Java应用自身保持无状态,扩容缩容都不影响入口。
- 请求头增强与日志透视:Nginx能统一注入Host、真实IP等请求头,Java后端拿到客户端真实来源,日志和排障都轻松一大截。
- 安全过滤和限流:非法UA、恶意IP、突发流量都可以在Nginx这一层先挡住,不用业务代码去实现。
这些能力组合起来,Nginx在Java架构里就是"总闸+分流器+保安"三重角色。哪怕你的服务只有一台机器,我也建议至少用Nginx把端口收敛一层,后续加机器、上HTTPS、做灰度都非常方便。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 第一份可用配置:location、proxy_pass与请求头传递
2.1 一个能跑起来的最小配置
不管多复杂的架构,最核心的就一段反向代理配置。假设Java服务跑在127.0.0.1:8080,我们想通过Nginx的80端口对外提供服务,最小配置长这样:
nginx复制server {
listen 80;
server_name yourdomain.com;
location / {
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;
}
}
这一段里最容易忽略的是proxy_set_header。Nginx转发给Java服务时,默认情况下Host头是127.0.0.1:8080而不是你访问的域名。如果Spring Boot应用里用到了request.getServerName()、生成链接地址或者做域名白名单,就会拿到错误的值。把$host传进去,后端才能正确识别域名。
X-Real-IP和X-Forwarded-For更容易被漏掉。没有这两行,Java后端获取到的客户端IP全是127.0.0.1,日志、风控、审计全废了。$proxy_add_x_forwarded_for会把原始请求头里的X-Forwarded-For追加当前客户端IP,支持多级代理场景。
配置完成后先nginx -t检查语法,再nginx -s reload热加载。不用重启进程是Nginx非常好用的特点,改配置基本零中断。
2.2 proxy_pass结尾斜杠:绝大多数人踩过的坑
proxy_pass后面到底带不带斜杠,这个细节我至少看了十几次同事栽跟头。它的规则其实不复杂:proxy_pass后面是否带URI,决定location匹配部分会不会被替换。
第一种,不带URI,只写主机地址:
nginx复制location /api/ {
