.NET 7实现JWT时遇ArgumentNullException空值异常求助

问题核心 #

你的代码尝试读取TokenKey配置时返回null，导致Encoding.UTF8.GetBytes()触发ArgumentNullException，本质是配置未被正确加载或读取路径错误。

排查解决步骤 #

1. 修正配置读取路径 #

你的TokenKey位于AppSettings节点下，直接用config["TokenKey"]无法读取，必须使用完整层级路径：

var tokenKey = config["AppSettings:TokenKey"];
if (string.IsNullOrEmpty(tokenKey))
{
    throw new InvalidOperationException("未找到TokenKey配置项");
}
var testing = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(tokenKey));

2. 确保配置文件被复制到输出目录 #

右键项目中的appsettings.json → 属性，设置复制到输出目录为「如果较新则复制」或「始终复制」。若配置文件未同步到运行目录，IConfiguration会读取不到任何配置值。

3. 验证配置加载逻辑（Program.cs） #

.NET7默认会自动加载appsettings.json，但如果自定义了配置构建逻辑，需确保显式包含该文件：

var builder = WebApplication.CreateBuilder(args);

// 确认以下配置加载代码存在（默认已包含，手动配置时需添加）
builder.Configuration
    .SetBasePath(Directory.GetCurrentDirectory())
    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
    .AddEnvironmentVariables();

4. 使用强类型绑定（更稳定可靠） #

创建配置实体类：

public class AppSettings
{
    public string TokenKey { get; set; } = string.Empty;
}

在Program.cs中绑定配置节点：

builder.Services.Configure<AppSettings>(builder.Configuration.GetSection("AppSettings"));

在扩展方法中读取配置：

public static IServiceCollection AddIdentityServices(this IServiceCollection services, IConfiguration config)
{
    var appSettings = config.GetSection("AppSettings").Get<AppSettings>() 
        ?? throw new InvalidOperationException("AppSettings配置未正常加载");
    
    var key = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(appSettings.TokenKey));
    // 后续JWT认证相关配置逻辑...
    
    return services;
}

5. 排查环境变量干扰 #

环境变量优先级高于配置文件，若系统/项目环境变量中存在AppSettings__TokenKey（用双下划线代替层级冒号）且值为空，会覆盖配置文件的设置。可在Program.cs启动时添加调试输出确认：

Console.WriteLine($"当前TokenKey配置值: {builder.Configuration["AppSettings:TokenKey"]}");

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