Asp.Net Core 2 Web API 500错误：如何配置Startup解决IConfigurationRoot解析失败

嘿，这个问题我之前也碰到过！本质是你的AuthController在构造时，依赖注入（DI）容器找不到Microsoft.Extensions.Configuration.IConfigurationRoot的注册服务——因为ASP.NET Core 2.x的DI容器默认只注册了IConfiguration接口，并没有直接把IConfigurationRoot加入服务集合，所以激活控制器时就抛出了这个500错误。

下面给你两种解决方案，优先推荐第一种：

方案1：改用框架推荐的IConfiguration注入（推荐） #

IConfiguration已经包含了IConfigurationRoot的所有配置读取能力，而且是ASP.NET Core官方推荐的配置注入接口。你只需要修改AuthController的构造函数，把注入类型从IConfigurationRoot改成IConfiguration即可：

using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Configuration;

namespace WebAPI.Controllers
{
    [Route("api/[controller]")]
    [ApiController]
    public class AuthController : ControllerBase
    {
        private readonly IConfiguration _config;

        // 把IConfigurationRoot替换成IConfiguration
        public AuthController(IConfiguration configuration)
        {
            _config = configuration;
        }

        // 你的token接口逻辑...
        [HttpPost("token")]
        public IActionResult GetToken([FromBody] LoginModel model)
        {
            // 这里可以正常用_config读取配置，比如：
            var jwtSecret = _config["Jwt:Secret"];
            // ...其他逻辑
        }
    }
}

这种方式不需要修改Startup类，完全符合框架的设计规范，也是最简洁的解决办法。

方案2：手动注册IConfigurationRoot到DI容器（仅特殊场景使用） #

如果你确实有必须使用IConfigurationRoot的场景（比如需要调用它特有的方法），可以在Startup类里手动把它注册到服务集合中：

首先确保Startup类的构造函数已经构建了IConfigurationRoot实例，然后在ConfigureServices里添加注册：

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;

namespace WebAPI
{
    public class Startup
    {
        // 保留IConfigurationRoot的引用
        public IConfigurationRoot Configuration { get; }

        public Startup(IHostingEnvironment env)
        {
            var configBuilder = new ConfigurationBuilder()
                .SetBasePath(env.ContentRootPath)
                .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
                .AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true)
                .AddEnvironmentVariables();
            
            // 构建得到IConfigurationRoot实例
            Configuration = configBuilder.Build();
        }

        public void ConfigureServices(IServiceCollection services)
        {
            // 手动把IConfigurationRoot注册为单例服务
            services.AddSingleton<IConfigurationRoot>(Configuration);

            // 注册Mvc服务（ASP.NET Core 2.x的写法）
            services.AddMvc();
        }

        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }

            app.UseMvc();
        }
    }
}

这样DI容器就能找到IConfigurationRoot的实现，你的AuthController就能正常激活了。

注意：除非你有明确的理由必须用IConfigurationRoot，否则强烈建议用方案1，因为IConfiguration是更抽象的接口，更符合依赖注入的“面向抽象编程”原则，也能让你的代码更灵活。

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