都是我的错-Windows Nginx新手执行指令配置无效

不像LinuxNginxWindows上执行,可以多次启动,每次启动都会生成基于配置文件中工作进程数+主进程(1)个数量的进程,不会有任何报错提示,在nginx.exe的配置文件conf配置目录下nginx.conf工作进程数配置如下,标识工作进程数为1,实际启动进程为两个,一个工作进程一个主进程

# user  root;
worker_processes  1;

启动命令后配置无效,对于刚刚接触Nginx来说的朋友,当真是热锅上的蚂蚁,团团转,本章主要是讲解作为新手在·Windows上使用Nginx,遇到此问题改如何排查和解决,此处为[官方链接]http://nginx.org/en/download.html,如果访问不到网站可联系笔者,获取Nginx高版本压缩包

都是我的错-Windows Nginx新手执行指令配置无效_第1张图片

问题场景

起初配置好以后是可以正常使用,修改了配置文件,重新启动发现,自己配置的相关内容,并没有生效,反复启动,依然无效,所谓的无效就是访问对应服务以及端口,自己最后一次配置的相关处理都好像没有配置一般,服务正常,配置无效执行重启指令后,服务配置无效停止服务再启动也无效

常见可能

服务多次启动

服务启动多次,会造成出第一次启动的服务能够正常生效外,其余都只是一个无用的子进程,推测为多次启动时,由于读取的是同一配置文件和监听的是统一服务端口号,造成后续启动的nginx.exe进程无法执行,只能等待,类似挂起状态,没有任何操作和响应,而Nginx for Windows每次启动都会将配置文件内容读取出来缓存在内存中,并不会应为配置变更,Nginx就重新加载配置内容,新的进程如果只是加载新的配置,并未正常执行,新的配置自然无效,问题复现

原始配置

原始配置此处以下载的Nginx for Windows软件包,解压之后的状态为例,所以本地配置文件仅仅只有一个80端口被作为服务监听端口

......省略.......
http {
......省略.......
    server {
        listen       80;
        server_name  localhost;

        location / {
            root   html;
            index  index.html index.htm;
        }
......省略.......
    }
}
第一次启动nginx

修改端口为7080并保存

......省略.......
http {
......省略.......
    server {
        listen       7080;
        server_name  localhost;

        location / {
            root   html;
            index  index.html index.htm;
        }
......省略.......
    }
}

启动cmd切换到nginx.exe所在目录下,执行指令start nginx,有一个黑框一闪而过

>start nginx
>tasklist /FI "IMAGENAME eq nginx.exe"

映像名称                       PID 会话名              会话#       内存使用
========================= ======== ================ =========== ============
nginx.exe                    23456 Console                    1      9,816 K
nginx.exe                    58692 Console                    1     10,348 K

请求浏览器请求http://localhost:7080,结果如下:

都是我的错-Windows Nginx新手执行指令配置无效_第2张图片

配置变更

此时增加nginx.conf中改server下的location匹配规则

......省略.......
http {
......省略.......
    server {
        listen       7080;
        server_name  localhost;

        location / {
            root   html;
            index  index.html index.htm;
        }
        
        #增加规则
		location /test/ {
            alias  html/;
			index  index.html index.htm;
        }
......省略.......
    }
}
第二次启动nginx
>start nginx
>tasklist /FI "IMAGENAME eq nginx.exe"

映像名称                       PID 会话名              会话#       内存使用
========================= ======== ================ =========== ============
nginx.exe                    23456 Console                    1      9,784 K
nginx.exe                    58692 Console                    1     10,308 K
nginx.exe                    54800 Console                    1      9,828 K
nginx.exe                    38372 Console                    1     10,352 K

这是时候,发现进程数量为四,与启动次数成正比,如果是查看nginx.exe同级目录下的logs文件夹下,可以发现一个nginx.pid文件,文件内容为54800,表示第二次启动时,写入的主进程id号,其实第一次启动时,也同样会写入该次启动时的主进程id,每次启动都会覆盖上一次启动的进程id,停止时会移除nginx.pid

理论上,此时请求http://localhost:7080/test能够同样访问到第一次启动时的页面,可是实际返回结果如下:

都是我的错-Windows Nginx新手执行指令配置无效_第3张图片

查看logs下的错误日志error.log内容为:

[error] 34444#57956: *1 "解压路径\nginx-1.21.1/html/test/index.html" is not found (3: The system cannot find the path specified)

确实没有这个路径,可是修改的配置是将test指向别名路径html文件夹,默认文件也是index.htm或者index.html,当前第二次配置文件内容无效

停止服务

执行-s stop指令,查看进程可以知道,第二次启动的进程已经结束,第一次的进程还存在,此时访问服务可以发现第一次的端口服务是正常的

>nginx -s stop
>tasklist /FI "IMAGENAME eq nginx.exe"

映像名称                       PID 会话名              会话#       内存使用
========================= ======== ================ =========== ============
nginx.exe                    23456 Console                    1      9,776 K
nginx.exe                    58692 Console                    1     10,304 K

执行停止指令或重启,发现已经无法启动,同时提示如下错误:

>nginx -s stop
nginx: [error] CreateFile() "./logs/nginx.pid" failed (2: The system cannot find the file specified)
>nginx -s reload
nginx: [error] CreateFile() "./logs/nginx.pid" failed (2: The system cannot find the file specified)
解决办法

查看该目录发现,改文件已经不存在,所有才会提示上述错误,意思就是不能够通过普通方式进行服务退出,这时候可以考虑直接执行taskkill指令进行处理,执行成功后,再查看对应进程nginx.exe,发现本地已经不存在对应镜像名称的进程了

>taskkill /F /IM nginx.exe /T
成功: 已终止 PID 50792 (属于 PID 58692 子进程)的进程。
成功: 已终止 PID 58692 (属于 PID 23456 子进程)的进程。
成功: 已终止 PID 23456 (属于 PID 57764 子进程)的进程。
>tasklist /FI "IMAGENAME eq nginx.exe"
信息: 没有运行的任务匹配指定标准。

再次执行start nginx启动,就能够访问对应修改之后的配置内容

都是我的错-Windows Nginx新手执行指令配置无效_第4张图片

最近一次配置异常

条件:下次服务重启前,不查看错误日志,无法发现问题

服务已经运行,页面能够正常访问到地址http://localhost:7080/nginx.conf配置如下:

......省略.......
http {
......省略.......
    server {
        listen       7080;
        server_name  localhost;

        location / {
            root   html;
            index  index.html index.htm;
        }
......省略.......
    }
}

最近一次修改时,造成配置疏忽:

......省略.......
http {
......省略.......
    server {
        listen       7080;
        server_name  localhost;

        location / {
            root   html;
            # 假定配置错误少些分号;结尾
            index  index.html index.htm
        }
......省略.......
    }
}

再次手误启动,无任何提示,运行时访问http://localhost:7080/,也是正常响应

>start nginx

查看nginx.exe中进程数也是正常的

>tasklist /FI "IMAGENAME eq nginx.exe"

映像名称                       PID 会话名              会话#       内存使用
========================= ======== ================ =========== ============
nginx.exe                    61380 Console                    1      1,280 K
nginx.exe                    59796 Console                    1      2,164 K

直到,哪天nginx.exe结束了程序再次重启,结果就是完了,服务不能用了,查看日志才发现,实际配置文件已经报错,当时在服务配置错误时,未查看系统中是否已经存在nginx服务前,就再次启动nginx服务,实际由于异常配置,实际服务并未启动,而是正常情况时的服务并未退出,造成的服务正常的假象

解决办法

善用nginx常规指令和良好的服务检测习惯

启动服务前,先核查本地是否已经启动服务

>tasklist /FI "IMAGENAME eq nginx.exe"

输出信息: 没有运行的任务匹配指定标准。,表示不存在对应镜像名称的进程存在服务时,过存在则会输出对应的进程列表清单,

已经存在进程时,对配置进行修改后,可以考虑先使用-t [confpath]对目标配置文件进行内容检测,不添加参数,默认为nginx.conf,以下为配置正常时的输出结果,配置异常时,会显示对应的异常配置位置大概位置,便于用户排查

>nginx -t
nginx: the configuration file 解压路径\nginx-1.21.1/conf/nginx.conf syntax is ok
nginx: configuration file 解压路径\nginx-1.21.1/conf/nginx.conf test is successful

确认配置无误后,使用-s reload进行服务重启,重启后的进程id和之前老的进程id是不一样的,可以规避对应的服务存存在假象,同时可以多看看异常日志,一般如果配置异常,日志中,有对应的异常日志输出

重启前

>tasklist /fi "imagename eq nginx.exe"

映像名称                       PID 会话名              会话#       内存使用
========================= ======== ================ =========== ============
nginx.exe                    38452 Console                    1     17,472 K
nginx.exe                    47260 Console                    1     17,824 K

重启后

>nginx -s reload

D:\Program Files\nginx-1.21.1>tasklist /fi "imagename eq nginx.exe"

映像名称                       PID 会话名              会话#       内存使用
========================= ======== ================ =========== ============
nginx.exe                    38452 Console                    1     17,392 K
nginx.exe                    22264 Console                    1     17,816 K

注意

实际进程不止俩,结束进程时,关联进程列表为,主进程,工作进程以及一个其他进程,上述文章中说的俩仅仅是限定范围到当前服务范围内,不过多延伸

如果想要获取上述例子中的nginx压缩包,可以评论留言或者私信笔者

你可能感兴趣的:(#,部署,假认真,技术总结,nginx,web服务器)