模板配置参考

本文按当前 ApiStandard 模板源码整理配置项。配置文件使用 ASP.NET Core 的标准配置系统：JSON、环境变量、用户密钥和命令行参数可以叠加，后加载的配置会覆盖前面的值。

MiniApi 复用缓存、认证、登录安全策略、SMTP、SMS 和 S3 等 Options；其 ComponentOption 不包含 Database 和 IsMultiTenant，数据库固定为 PostgreSQL，也不提供内置的 EF Core 迁移资源。下文涉及数据库选择和多租户的内容仅适用于 ApiStandard。

配置来源

模板运行时有两类配置：

• src/AppHost/appsettings*.json：由 AppHost 读取，用于选择数据库、缓存并传递租户配置，在 Aspire 启动时统一注入服务。
• src/Services/ApiService 和 src/Services/AdminService 的 appsettings*.json：服务自身配置，用于认证、CORS、缓存策略和可选工具组件。

使用 Aspire 启动时，AppHost 会把基础设施选择统一传给服务：

环境变量中的 __ 对应配置路径中的 :。例如：

$env:Components__IsMultiTenant = "true"
$env:Authentication__Jwt__Sign = "replace-with-a-secret"

直接运行某个服务时，不会经过 AppHost 注入；此时应在服务的配置文件、环境变量或密钥服务中提供相同配置。

Components

Components 绑定到 ComponentOption，常用配置如下：

当前 ComponentOption 没有 Components:UseOpenAPI 属性，模板代码也不会读取它；不要使用它控制 OpenAPI。ApiStandard 是否映射 Swagger 由当前服务默认配置决定，MiniApi 使用 ASP.NET Core OpenAPI。

Cache

Cache 绑定到 CacheOption，时间单位为分钟：

Authentication

Jwt

路径为 Authentication:Jwt，生产环境至少应通过环境变量或密钥服务提供 Sign：

OAuth

路径为 Authentication:OAuth：

示例中的 Authentication:OAuth:ClientId 不属于当前 OAuthOption 的绑定属性；第三方登录的 Microsoft/Google 客户端配置见下文。

LoginSecurityPolicy

路径为 LoginSecurityPolicy：

可选工具组件

只有对应的 Components:Use* 为 true 时，模板才会注册这些 Options：

其他配置节点

下列配置不属于上述自定义 Options，但会被模板直接读取：

• Cors:AllowedOrigins：生产环境允许的来源列表。
• Cors:AllowedSubdomains：是否允许来源的通配子域名。
• Authentication:Microsoft 和 Authentication:Google：当 ClientId、ClientSecret、CallbackUrl 均有效时注册第三方登录。
• ConnectionStrings:Default、ConnectionStrings:Analysis 和 ConnectionStrings:Cache：分别用于默认业务数据库、可选分析数据库和缓存。未配置Analysis时使用Default；使用现有数据库或缓存时，可在 AppHost 中通过 AddConnectionString 统一提供。
• OTEL_EXPORTER_OTLP_ENDPOINT：Aspire 注入的 OpenTelemetry 导出地址。

迁移相关环境变量

迁移生成脚本和 AppHost 使用以下变量保持模型一致：

• Components__Database：决定生成 SQL 的数据库提供程序。
• Components__IsMultiTenant：由AppHost和迁移脚本传递给服务；它不决定是否生成租户索引，TenantIndexConvention会统一处理实现ITenantEntityBase的实体。

EF Core 迁移、初始化数据和生产发布流程请参阅数据库迁移与初始化和发布应用。