树莓派部署.NET6 Swagger API访问返回401无法访问求助

核心401错误修复 #

• 错误原因：你在请求管道中启用了app.UseAuthentication()和app.UseAuthorization()认证授权中间件，但没有在服务注册阶段调用AddAuthentication()配置任何可用的认证方案（如JWT、Cookie认证等），授权中间件无法完成认证逻辑，会直接拦截所有未被前置中间件处理的请求返回401。
  • 临时修复（无认证需求场景）：直接删除Program.cs中app.UseAuthentication();、app.UseAuthorization();两行代码即可。
  • 长期修复（需要认证功能场景）：在builder.Services.AddControllers();代码前注册对应认证方案，以JWT认证为例：

    builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
        .AddJwtBearer(options =>
        {
            // 按业务需求配置JWT密钥、颁发者、过期时间等参数
        });
    builder.Services.AddAuthorization();
    

• 访问路径错误：根路径http://localhost:5000/默认没有绑定任何页面，Swagger UI的默认访问地址是http://localhost:5000/swagger。如果需要访问根路径直接跳转Swagger，可在app.UseSwaggerUI();代码后添加重定向规则：

  app.MapGet("/", () => Results.Redirect("/swagger"));
  

其他运行时必现问题修复 #

• 数据库连接字符串不兼容Linux环境：当前配置的连接字符串使用(localdb)\\mssqllocaldb，这是Windows专属的SQL Server LocalDB组件，在Debian（树莓派运行的系统）上无法正常运行。可根据需求替换为支持ARM64/Linux的数据库：
  • 本地测试优先选SQLite，轻量无额外部署成本，EF Core对ARM架构兼容性好，示例连接字符串：

    "programContext": "Data Source=./app.db"
    

    对应DbContext配置要把UseSqlServer改为UseSqlite。
  • 生产环境可选PostgreSQL、MySQL，或在可访问的Windows/服务器设备上部署标准版SQL Server，将连接字符串指向对应数据库地址即可。
• 连接字符串键名不匹配：Program.cs中读取的连接字符串键为Context，但appsettings.json中配置的键为programContext，首次访问涉及数据库操作的接口时会抛出连接字符串找不到的异常，需要将读取代码修改为：

  options.UseSqlServer(builder.Configuration.GetConnectionString("programContext") ?? throw new InvalidOperationException("Connection string 'programContext' not found."))
  

Nginx反向代理配置优化 #

当前Nginx配置缺少必要的转发头，会导致应用无法获取真实客户端IP、原始请求信息，建议在location配置块中补充：

proxy_set_header   X-Forwarded-Host $host;

如果需要通过Nginx转发HTTPS请求，要在Program.cs的最顶部（所有其他中间件注册前）添加反向代理头处理配置：

builder.Services.Configure<ForwardedHeadersOptions>(options =>
{
    options.ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto;
    options.KnownNetworks.Clear();
    options.KnownProxies.Clear();
});
var app = builder.Build();
app.UseForwardedHeaders();
// 后续原有中间件代码保持不变

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