在 nginx 源码编译时配置静态资源处理模块，核心在于使用 --with-http_static_module 参数。该模块默认包含在标准发行版中，但通过显式指定可确保其被正确构建并链接到最终的二进制文件中。执行此操作后，nginx 将具备直接提供文件服务的能力，无需依赖第三方插件或复杂的 lua 脚本。
如何验证静态模块是否已加载
编译完成后，可以通过命令行工具检查当前 Nginx 二进制文件支持的模块列表。使用 -V 参数（大写）可以输出详细的版本信息和编译参数。如果在输出结果中看到 --with-http_static_module，则说明静态资源处理功能已经成功集成。这一步是排查“404 Not Found”或“500 Internal Server Error”等常见静态文件访问错误的首要步骤，因为如果模块未编译进去，Nginx 根本不会尝试解析静态路径。
./configure --prefix=/usr/local/nginx --with-http_ssl_module --with-http_static_module make sudo make install nginx -V
上述命令序列展示了从配置、编译到安装的标准流程。其中 --prefix 指定了安装目录，--with-http_ssl_module 用于启用 HTTPS 支持，而关键的 --with-http_static_module 确保了静态文件服务的可用性。运行 nginx -V 后，若终端返回包含该参数的字符串，即表示配置生效。此时，Nginx 已经准备好处理位于 root 或 alias 指令指定目录下的文件请求。
静态模块与 location 指令的配合逻辑
仅仅编译进模块是不够的，还需要在配置文件中使用 location 块来激活它。当客户端发起一个针对特定路径的请求时，Nginx 会根据 location 的定义来决定如何处理。对于静态资源，通常使用精确匹配或前缀匹配来指向磁盘上的具体目录。例如，设置 location /static/ 可以将所有以 /static/ 开头的请求映射到服务器本地的某个文件夹。这种映射关系决定了 Nginx 如何在文件系统上查找文件，以及在没有找到文件时返回何种错误码。
server {
listen 80;
server_name example.com;
root /var/www/html;
location /images/ {
alias /data/uploads/images/;
autoindex on;
}
}
在这个配置示例中，root 指令定义了全局的文档根目录，而 location /images/ 块内部使用了 alias 指令。这里的关键区别在于：root 会将 /images/ 追加到根目录后，形成 /var/www/html/images/；而 alias 则会用 /data/uploads/images/ 完全替换 /images/ 部分。因此，请求 /images/logo.png 时，Nginx 实际读取的是 /data/uploads/images/logo.png。此外，autoindex on 开启了目录浏览功能，这在开发环境中非常有用，但在生产环境中应谨慎使用以避免信息泄露。
当请求的文件不存在时 Nginx 返回什么状态码
如果配置的静态路径下找不到对应的文件，Nginx 默认会返回 HTTP 404 Not Found 状态码。这是由 http_static_module 的内部逻辑决定的：当文件读取系统调用失败且非权限问题时，模块会终止处理并生成 404 响应。开发者可以通过 error_page 指令自定义这一行为，例如将其重定向到一个友好的错误页面或触发后端 API 调用。理解这一默认行为有助于快速定位资源缺失问题，而不是误以为是模块配置错误。
