AppSettings读取失败主因是配置文件未正确加载到IConfiguration链中，需检查文件路径、环境变量、加载时机及类型转换。
AppSettings 读取失败：检查 appsettings.json 是否被正确加载
常见错误是代码里调用 Configuration.GetValue<string>("Key")</string> 或 Configuration["Key"] 返回 null，但配置文件明明写了。根本原因往往是 appsettings.json 没进 IConfiguration 构建链。
实操建议：
- 确认
Program.cs中用了Host.CreateDefaultBuilder()（.NET 6+）或手动调用了configuration.AddJsonFile("appsettings.json", optional: false, reloadOnChange: true) -
appsettings.json文件属性必须设为“复制到输出目录：始终复制”或“如果较新则复制” - 路径区分大小写——Linux/macOS 下
AppSettings.json≠appsettings.json - 别在
Startup.ConfigureServices之前直接用Configuration，此时它还没构建完
.NET 6+ 中 IConfiguration 和 IOptions<t></t> 怎么选
不是所有场景都该用 IOptions<t></t>。它适合结构化配置（比如整个 "Logging" 节点），而单个字符串、布尔值之类，直接用 IConfiguration 更轻量。
实操建议：
- 读单个值：用
Configuration.GetValue<int>("AppSettings:Timeout")</int>或Configuration["AppSettings:Timeout"]（注意冒号分隔） - 读对象：定义类
public class AppSettings { public int Timeout { get; set; } }，注册services.Configure<appsettings>(Configuration.GetSection("AppSettings"))</appsettings>，注入IOptions<appsettings></appsettings> -
IOptionsSnapshot<t></t>支持热重载（reloadOnChange: true时），IOptions<t></t>只初始化一次 - 别在静态方法里硬依赖
IOptions<t></t>——它不是静态的，得靠 DI 容器提供
环境配置没生效：appsettings.Development.json 不起作用
典型现象：开发机上改了 appsettings.Development.json，但 Configuration["Key"] 还是返回 appsettings.json 里的旧值。问题出在环境变量或启动参数没对上。
实操建议：
- 检查
ASPNETCORE_ENVIRONMENT环境变量是否设为Development（Windows 命令行：set ASPNETCORE_ENVIRONMENT=Development；Linux/macOS：export ASPNETCORE_ENVIRONMENT=Development） - .NET 6+ 的
Program.cs默认已调用AddEnvironmentVariables()，但若手动构建IConfiguration，需显式加.AddJsonFile($"appsettings.{environment.EnvironmentName}.json", optional: true) - 环境名不支持点号以外的分隔符，
appsettings.MyTest.json不会自动加载，除非你手动指定 - 多个同名 Key 时，后加载的文件覆盖先加载的——确保
appsettings.Development.json在appsettings.json之后加载
配置值是空字符串或默认值？小心类型转换失败
Configuration.GetValue<int>("Port")</int> 返回 0 不一定代表配置写了 "0"，很可能是字符串转 int 失败后回退到 default(int)。这在调试时极难察觉。
实操建议：
- 优先用
Configuration.GetValue<int>("Port")</int>，null 可明确区分“没配”和“配了 0” - 字符串值务必检查是否为空：
string.IsNullOrEmpty(Configuration["ApiKey"]) == true才算缺失 - 避免链式调用如
Configuration["Logging:LogLevel:Default"].ToLower()——前面为 null 会直接抛NullReferenceException - 复杂类型绑定失败时，
Configuration.GetSection("SectionName").Get<myclass>()</myclass>返回null，不会抛异常，要自己判空
配置读取看着简单，真正卡住人的永远是加载时机、环境匹配和类型隐式转换这三块。尤其在跨环境部署时，别只信日志里打印出来的 key 名，抓包看实际加载了哪些文件更靠谱。
