Sitecore补丁文件引用Docker环境变量取值为空问题咨询

你可能遗漏的配置步骤如下： #

• 配置补丁未添加正确的patch属性，且加载优先级低于默认配置
  Sitecore默认的sourceFolder变量定义在核心配置文件中，直接新增同名变量不会覆盖原有定义，需要给配置节点添加patch:instead属性明确替换原有配置，格式如下：

<sc.variable name="sourceFolder" value="$(env:ITEM_SYNC_LOCATION)" patch:instead="*[@name='sourceFolder']" />

同时要确保你的补丁文件放在App_Config/Include下优先级更高的目录（比如以zzz开头的自定义目录），避免被后续加载的默认配置覆盖。

• 未开启IIS应用池的用户配置加载权限
  Windows容器中IIS的应用池默认未开启用户配置加载，无法读取系统级环境变量。你需要在CM容器的启动脚本或镜像构建步骤中添加以下PowerShell命令，修改Sitecore站点对应应用池的配置：

# 替换为你站点对应的应用池名称，默认Sitecore 10.1容器的CM应用池名为sitecore.com
Set-ItemProperty -Path 'IIS:\AppPools\sitecore.com' -Name 'processModel.loadUserProfile' -Value $true

• 环境变量语法或拼写错误
  首先确认你使用的Sitecore 10.1版本支持$(env:变量名)的配置语法，同时检查环境变量名的拼写是否与docker-compose中定义的完全一致。你可以进入CM容器的Sitecore控制面板，打开「配置渲染」页面，搜索sourceFolder变量，确认当前实际加载的配置值，排查配置是否被正确应用。

内容的提问来源于stack exchange，提问作者Massimo Della Calce