解决Nginx端口冲突的排查方法

问题描述

一个Spring + Angular先后端分离的项目，使用Nginx进行数据转发。
Nginx监听端口8100，前台端口4200，后台端口8080。

像往常同样，提早配置好MySQL、配置好Redis，引入项目的Nginx配置文件，而后启动前台、后台，成功。

接下来出现了问题：前台发起的请求，只有极少数能被后台接收到，大部分都是404，随着在浏览器中的点击，控制台不断的出现404。

若是只是404，那问题就很简单，很大多是Nginx端口转发设置错了。但它的神奇之处就在于，还有那么几回请求，是能到达后台的。

（上图中，显示保存成功的时候，后台确实输出了相关的控制台信息）

其余的小伙伴都没有出现这个问题，因而开始排查。

排查过程

为了搞清楚是后端的问题仍是Nginx转发的问题，须要先从浏览器的NetWork中看一下这个404是后台返回的仍是Nginx返回的。

通过查看，发现是Nginx返回的。若是是后台返回的404，会把错误信息写在HTTP请求头中。

先查看监听端口是否有冲突，使用nginx -T能够查看完整的Nginx配置文件，包括引入的外部文件。

// 测试配置文件是否正确，并输出完整的配置文件
nginx -T

在输出的结果中，只看到一个8100，说明虽然引入了多个项目，但并无出现监听端口冲突。

而后笔者打算从Nginx日志中寻找一些蛛丝马迹。

开启Nginx的日志模式以后，查看日志文件，发现了上千条访问记录

大多数都是404，少数是200，但日志并无提供什么有用的信息。

最终，仍是在配置文件中发现了问题：

使用HomeBrew安装的Nginx，它的全局配置文件中，默认的监听端口就是8080，而项目后端占用的端口也是8080。

虽然对于端口监听和端口占用的原理不是很了解，至少能够知道，因为Nginx监听了8080端口，有一部分请求被发到了Nginx本身那里，另外一部分才是发送到后台。

因此，修改全局配置文件，改掉默认端口，问题解决。

// 修改配置文件
sudo vim /usr/local/etc/nginx/nginx.conf
// 测试配置文件
nginx -t
// 重启Nginx
nginx -s reload

终于，全部的请求都能达到后台了。

总结

在一开始学习XAMPP的时候，就常常听到：“若是80端口冲突，就把端口改掉，好比改为8080”。
但是当8080成为了咱们的习惯以后，有些项目也会使用这个端口...所以就要解决冲突问题了。

之后更改默认端口的时候，建议改为一个不可能用到的端口，好比10000以上的端口号，避免和项目的端口产生冲突。

下周计划

本周因为跑环境、做息时间调整、补充遗忘的知识、从新看教程等等缘由，几乎一行代码也没有敲，博客写的也比较水，所以学习状态有待改进。

下周计划：

• 用四天时间完成Alice项目全部接口的参数校验
• 用后两天至少完成两个Issue
• 天天晚上利用空余时间，复习教程中关于测试的内容，下周末以前看完

版权声明

本文做者： 河北工业大学梦云智开发团队 - 刘宇轩