注入Azure Table Storage服务到MediatR Handler时出现Base64编码异常

问题根因 #

你遇到的MediatR Handler构造失败是表面现象，真正的错误来自内部的Base64格式校验异常：Azure Table Storage服务初始化时，拿到的账户访问密钥（AccountKey）或完整连接字符串格式非法。单元测试正常是因为你直接传入了正确的明文值，运行时从配置源读取配置的环节出了问题。

常见触发原因及修复方案 #

• 配置读取时特殊字符被转义
  Azure存储账户密钥本身是Base64编码，包含+、/、=等特殊字符，如果你存在环境变量、命令行参数这类配置源中，+很容易被自动转义为空格，=会被当作参数分隔符截断，导致拿到的密钥不完整。如果是存放在appsettings.json中，要确保字符串两端加了双引号，没有被json语法错误截断。
• 配置键名写错
  大部分配置源对键名大小写敏感，如果你把配置键比如"AzureStorage:AccountKey"写成了"AzureStorage:accountkey"，会读到空值或错误值，最终传给Azure服务构造函数的参数非法。
• 配置源优先级冲突
  本地开发时用户机密（Secret Manager）、环境变量的优先级高于appsettings.json，如果你之前在高优先级配置源中存了旧的错误密钥，会覆盖你后续修改的正确配置，最终读到错误值。

快速排查方法 #

在Startup.cs的服务注册逻辑中，先把拿到的连接字符串/密钥打印出来，和你单元测试用的正确值做对比：

// 注册服务前先验证配置合法性
var storageConnStr = configuration.GetValue<string>("你的配置键名");
// 打日志或者断点看这里的实际值，和单元测试用的对比即可定位问题
Console.WriteLine($"实际读取到的存储连接字符串：{storageConnStr}");
// 提前做Base64校验，启动时就暴露问题，不用等到Handler调用才报错
if (storageConnStr != null && storageConnStr.Contains("AccountKey="))
{
    var accountKey = storageConnStr.Split("AccountKey=")[1].Split(';')[0].Trim();
    if (!Convert.TryFromBase64String(accountKey, new byte[accountKey.Length], out _))
    {
        throw new InvalidOperationException("存储账户密钥不是合法的Base64格式，请检查配置");
    }
}
// 再注册服务
services.AddScoped<ITableStorageService>(_ => new TableStorageService(storageConnStr));

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