Ubuntu Nginx环境下.Net应用登录后502错误及日志异常排查

关键错误分析 #

从journalctl日志中可定位核心问题：

1. 防伪令牌解密失败：根源是密钥环中找不到指定密钥{XXXXXX}，触发AntiforgeryValidationException
2. HTTPS重定向端口无法确定：应用无法识别前端HTTPS端口，引发警告
3. 进程崩溃：应用因ABRT信号退出，推测是CS.Globals.LogError递归调用导致栈溢出

解决方案 #

1. 修复数据保护密钥环缺失问题 #

.NET应用的防伪令牌、会话数据依赖数据保护密钥环，密钥丢失会直接导致解密失败：

• 检查默认密钥存储目录：/var/lib/dotnet/dataprotection-keys/，确认是否存在包含{XXXXXX}的密钥文件
• 若密钥文件丢失，二选一处理：
  • 恢复备份密钥：将备份的密钥文件放回上述目录，设置权限：sudo chown -R dotnet:dotnet /var/lib/dotnet/dataprotection-keys/
  • 重新生成密钥（会失效现有会话，需用户重新登录）：

    sudo rm -rf /var/lib/dotnet/dataprotection-keys/
    sudo systemctl restart kestrel-helloapp.service
    

• 可选：自定义密钥存储路径，在appsettings.json中添加配置：

  "DataProtection": {
    "Keys": {
      "PersistKeysToFileSystem": {
        "Path": "/opt/helloapp/keys"
      }
    }
  }
  

  创建路径并设置权限：sudo mkdir -p /opt/helloapp/keys && sudo chown dotnet:dotnet /opt/helloapp/keys

2. 配置HTTPS转发头解决重定向警告 #

Nginx作为反向代理，需传递正确的转发头让.NET应用识别HTTPS环境：

• 修改Nginx站点配置（如/etc/nginx/sites-available/helloapp），添加转发头：

  location / {
    proxy_pass http://localhost:5000; # 替换为你的应用监听端口
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection keep-alive;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $remote_addr;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Forwarded-Port $server_port;
  }
  

• 在应用Program.cs中配置转发头中间件（需放在UseHttpsRedirection之前）：

  app.UseForwardedHeaders(new ForwardedHeadersOptions
  {
    ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto
  });
  

3. 修复进程崩溃问题 #

日志中重复调用CS.Globals.LogError是典型递归调用，会导致栈溢出触发ABRT信号：

• 检查CS.Globals.LogError实现，移除递归逻辑（比如避免在异常处理分支中再次调用自身）
• 若需进一步排查崩溃细节，使用dotnet-dump工具：

  sudo apt install dotnet-dump
  # 应用运行时捕获转储
  sudo dotnet-dump collect -p $(pgrep dotnet)
  # 分析转储文件
  sudo dotnet-dump analyze <转储文件名>
  

验证步骤 #

1. 完成上述修复后，重启Nginx和应用服务：

   sudo systemctl restart nginx
   sudo systemctl restart kestrel-helloapp.service
   

2. 重新测试登录流程，检查journalctl日志是否无错误：

   sudo journalctl -fu kestrel-helloapp.service
   

内容的提问来源于stack exchange，提问作者kgcwc09