.NET Core中IOptions注入后配置值被篡改的问题排查

你犯的核心错误是直接修改了IOptions<WopiOptions>返回的实例。在.NET Core中，IOptions<T>注入的是单例对象，整个应用里只有一个WopiOptions实例。当你修改_wopiOptions.Value.HostPageDomain时，本质是修改了这个全局共享的实例，导致后续所有请求都会拿到被修改过的值，而非原始配置。

有两种常用修复方式：

1. 改用IOptionsSnapshot<T> #

IOptionsSnapshot<T>是请求级别的对象，每次请求都会从配置重新绑定新实例，修改当前请求的实例不会影响其他请求。

修改控制器注入代码：

private readonly IOptionsSnapshot<WopiOptions> _wopiOptions;

public HomeController(IOptionsSnapshot<WopiOptions> wopiOptions)
{
    _wopiOptions = wopiOptions;
}

Action中修改逻辑：

public async Task<IActionResult> Index()
{
    var siteName = HttpContext.GetSiteName();
    var tenant = await _commonRepository.GetTenantAsync(siteName);
    // 当前请求专属实例，修改不影响全局
    var wopiOptions = _wopiOptions.Value;
    var modifiedDomain = wopiOptions.HostPageDomain.Replace(":sitename", tenant.SiteName.ToLower());

    model.OldWopiOptions = _wopiOptions.Value.HostPageDomain; // 始终是原始值
    model.WopiOptions = modifiedDomain;

    return View(model);
}

2. 手动创建配置副本 #

如果不想切换注入类型，可以复制原始配置到新对象，修改副本而非原始实例：

public async Task<IActionResult> Index()
{
    var siteName = HttpContext.GetSiteName();
    var tenant = await _commonRepository.GetTenantAsync(siteName);
    // 复制原始配置到新对象
    var wopiOptions = new WopiOptions
    {
        HostPageDomain = _wopiOptions.Value.HostPageDomain
    };
    wopiOptions.HostPageDomain = wopiOptions.HostPageDomain.Replace(":sitename", tenant.SiteName.ToLower());

    model.OldWopiOptions = _wopiOptions.Value.HostPageDomain; // 原始值不受影响
    model.WopiOptions = wopiOptions.HostPageDomain;

    return View(model);
}

• IOptions<T>适合读取静态配置，实例在应用启动时创建并全局缓存。
• IOptionsSnapshot<T>适配多租户或请求级动态配置场景，每次请求重新加载配置。
• 若需配置文件修改后自动刷新，可使用IOptionsMonitor<T>。

内容的提问来源于stack exchange，提问作者A. Gladkiy