Azure App Service发布后报500错误：Value cannot be null. (Parameter 'containerId')

问题根因分析 #

你遇到的ArgumentNullException: Value cannot be null. (Parameter 'containerId')报错本质是CosmosDB初始化MemberService时，传入的容器名称参数为空，具体可分为以下几类常见原因：

• 初始化代码配置键不匹配：你贴出的是FilesService的初始化代码，但报错堆栈指向的是MemberService的初始化方法InitializeCosmosMemberClientInstanceAsync，大概率是该方法读取容器名称的配置键和appsettings.json中实际的键不匹配。比如代码里读取的是MemberContainer，但配置文件里对应的键是ContainerName，导致读到空值。
• Azure App Service配置覆盖：Azure平台的应用配置优先级高于本地appsettings.json文件，如果你在Azure门户的App Service「设置-配置」板块中，配置了空的CosmosDbProd:ContainerName（Windows环境）或者CosmosDbProd__ContainerName（Linux环境），或者漏配该配置项，也会导致读取到空值。
• 环境配置文件不匹配：本地调试默认使用appsettings.Development.json配置，发布到Azure后默认使用Production环境，如果你的ContainerName配置只写在开发环境配置文件里，生产环境配置文件中缺失该配置，也会触发空值报错。
• 配置文件未正确发布：如果appsettings.json的「复制到输出目录」属性设为「不复制」，发布时不会带上配置文件，自然读不到对应配置。

排查解决步骤 #

1. 优先检查Azure侧配置：进入App Service的「设置-配置」页面，在「应用程序设置」tab下，确认是否存在CosmosDbProd:ContainerName（Windows部署）或者CosmosDbProd__ContainerName（Linux部署）的配置项，值是否为Member。如果不存在就新增配置，保存后重启应用即可。
2. 核对Member服务初始化代码：找到报错里的InitializeCosmosMemberClientInstanceAsync方法，检查读取容器名称的代码是否和配置键一致，确认读取的是"ContainerName"，示例正确代码如下：

// 正确写法，和appsettings里的键匹配
string containerName = configurationSection.GetSection("ContainerName").Value;

3. 验证配置文件发布属性：右键点击项目中的appsettings.json，选择「属性」，确认「复制到输出目录」属性设为「如果较新则复制」。
4. 确认环境配置一致性：检查你的appsettings.Production.json（如果有）中是否也配置了完整的CosmosDbProd节点，避免开发、生产环境配置不一致。

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