NGINX Unit 1.34.0 静态路由访问不存在的文件导致崩溃问题分析

NGINX Unit 是一个动态的Web和应用服务器，它支持多种编程语言和运行时环境。在1.34.0版本中，用户报告了一个严重的问题：当访问静态路由中不存在的文件时，会导致router进程崩溃并产生core dump。

问题现象

在NGINX Unit 1.34.0版本中，配置了静态文件路由后，当用户请求不存在的静态文件时，系统会出现以下异常行为：

1. router进程崩溃并产生core dump
2. 所有应用进程被强制重启
3. 客户端收到空响应（Empty reply from server）
4. 日志中会出现"process exited on signal 11 (core dumped)"的错误信息

问题复现

这个问题在多种环境下都能稳定复现，包括：

• Ubuntu 22.04 Docker容器
• Ubuntu 22.04 LXD容器
• 原生Ubuntu 22.04系统

最小复现配置如下：

{
  "listeners": {
    "*:80": {
      "pass": "routes"
    }
  },
  "routes": [
    {
      "match": {
        "uri": "~/static/.*$"
      },
      "action": {
        "share": "/app$uri",
        "fallback": {
          "return": 404
        }
      }
    }
  ]
}

当访问/static/non-existent-file这样的路径时，就会触发崩溃。

问题根源

经过开发团队分析，这个问题与OpenTelemetry(OTel)模块有关。在1.34.0版本中，当处理静态文件路由的404返回时，OTel模块中的某些代码路径会导致内存访问越界，从而引发段错误(Segmentation Fault)。

解决方案

这个问题已经在NGINX Unit的主干分支中修复，并将在1.34.1版本中发布。对于急需解决此问题的用户，有以下临时解决方案：

1. 等待官方1.34.1版本发布：这是最推荐的解决方案，预计很快就会发布。

2. 重新编译Unit：

   • 在编译时去掉--otel配置选项
   • 或者手动应用修复补丁d699fb9da6858b57d713a0567b4a9fbe47574cbd

3. 降级到1.33.0版本：如果功能允许，可以暂时回退到上一个稳定版本。

技术细节

这个问题的本质是当处理静态文件路由的404返回时，OTel模块尝试访问已经释放的内存区域。具体表现为：

1. 当请求不存在的静态文件时，Unit会触发fallback处理
2. 在准备返回404响应时，OTel模块错误地访问了无效的内存指针
3. 这导致router进程收到SIGSEGV信号(信号11)而崩溃
4. 主进程检测到router崩溃后，会重新启动router和所有应用进程

验证修复

根据用户反馈，1.34.1版本已经解决了这个问题。在升级后，系统能够正确处理不存在的静态文件请求，返回预期的404状态码，而不会导致进程崩溃。

最佳实践建议

对于生产环境中的NGINX Unit部署，建议：

1. 在升级前充分测试新版本
2. 关注官方发布说明和已知问题
3. 对于关键业务系统，考虑等待小版本(.1)发布后再升级
4. 配置完善的监控系统，及时发现和处理类似崩溃问题

这个问题提醒我们，即使是成熟的开源项目，在新版本中也可能引入回归问题。保持对生产环境的监控和准备回滚方案是非常重要的运维实践。