解决 Nginx 报错：invalid number of arguments in "return" directive - 解决Nginx配置规则错误 - 经验分享

在维护网站服务器的过程中，修改 Nginx 配置文件后，不少运维人员或开发者会遇到各种各样报错。下边简单解决一下 nginx: [emerg] invalid number of arguments in "return" directive 这样的错误提示。这种错误通常会导致配置文件测试失败，进而导致 Nginx 无法重启或重新加载。本文将以 Nginx 1.28.0 版本为例，深入剖析这一报错的根本原因，并提供精准的解决方案。

一、报错现象分析

根据用户提供的错误日志，问题出在重定向（Redirect）配置文件中：

nginx: [emerg] invalid number of arguments in "return" directive in /www/server/panel/vhost/nginx/redirect/www.ladmire.cn/xxx.conf:3 nginx: configuration file /www/server/nginx/conf/nginx.conf test failed

这里的关键点在于 "invalid number of arguments"（参数数量无效）。在 Nginx 的语法规范中，return 指令对参数的格式有着严格的要求。如果参数之间出现了不该有的空格，Nginx 就会认为你传递了过多的参数，从而抛出异常。

二、找出错误的根源

观察提供的原始配置代码片段，我们可以锁定问题所在：

错误代码示例：

return 301 https://www.ladmirr.cn $request_uri;

在这个例子中，return 后面紧跟着三个独立的部分：

301：状态码（第一个参数）
https://www.ladmirr.cn：目标域名（第二个参数）
$request_uri：变量（第三个参数）

症结所在：在 Nginx 中，return 301 后面只能接收一个目标 URL 字符串。如果你在域名和变量 $request_uri 之间加了空格，Nginx 会将它们视为两个独立的参数。由于参数超标，配置自然无法通过校验。

三、如何正确修复配置

修复的方法非常简单：去掉域名与变量之间的空格，将它们合并为一个完整的字符串。

1. 标准修复方案

将上述错误行修改为：

return 301 https://www.ladmirr.cn$request_uri;

2. 完整配置演示

以下是修正后的重写逻辑代码块，您可以直接参考：

#REWRITE-START
        if ($host ~ '^ladmire.cn'){
            return 301 https://www.ladmirr.cn$request_uri;
        }
#REWRITE-END

注意：在修改时请确保域名拼写准确。

四、进阶建议与避坑指南

为了避免类似问题再次发生，在编辑 Nginx 配置文件时可以遵循以下原则：

严格检查空格：Nginx 配置文件对空格极其敏感。变量如 $request_uri、$host 等在作为 URL 一部分时，必须紧贴前方的字符串。
善用引号：如果你的 URL 中包含特殊字符或空格（虽然 URL 不推荐含空格），可以使用双引号将整个目标路径包裹起来，例如 return 301 "https://www.ladmire.cn$request_uri";。
分段检查：如果您使用的是宝塔面板（BT Panel），重定向规则往往分布在独立的 conf 文件中。请务必检查 /vhost/nginx/redirect/ 目录下的细分文件，而不仅仅是大配置文件。
先测试再重载：每次修改后，请务必执行 nginx -t。只有看到 syntax is ok 和 test is successful 的提示后，再执行 nginx -s reload或者启动nginx。