Azure Container Apps挂载Azure File Share卷更新YAML报#x0000字符错误

算力阿峰

2026-8-29

问题根因

报错unacceptable character #x0000和CRLF换行、YAML格式、command: []字段无关，核心原因是Windows PowerShell下使用>重定向CLI输出时，默认会以UTF-16 LE编码保存文件，文件中会插入大量NULL空字节（即报错提到的#x0000字符），YAML解析器无法识别这类字符，所以哪怕不对导出的文件做任何修改，直接执行更新也会报错。
导出的YAML中出现command: []是正常输出，代表容器使用镜像内置的默认ENTRYPOINT启动，不需要手动删除，不影响配置生效。
额外注意贴出的命令里存在文件名不一致问题：导出的文件名为app.yaml，但更新命令里指定的yaml文件是my-app.yaml，如果文件名不匹配也会导致读取错误。

解决步骤

正确导出无编码问题的YAML文件
不要直接用>重定向输出，在PowerShell中执行以下命令导出UTF-8无BOM编码的配置文件：
```
az containerapp show -n <APP_NAME> -g <RESOURCE_GROUP_NAME> -o yaml | Out-File -FilePath app.yaml -Encoding utf8NoBOM
```
如果使用旧版PowerShell没有utf8NoBOM编码选项，导出后用VS Code打开文件，点击右下角编码标识，选择「通过编码重新保存」，选择UTF-8格式即可清除文件内的空字节。
编辑YAML添加SMB文件共享挂载配置
需要在配置中新增两个配置段：
- 在template层级下新增volumes数组，关联之前在ACA环境中注册的存储
- 在对应容器的配置段下新增volumeMounts数组，指定卷挂载到容器内的具体路径

执行更新命令，注意指定的文件名和编辑的文件名保持一致：

az containerapp update --name <APP_NAME> --resource-group <RESOURCE_GROUP_NAME> --yaml app.yaml

可用脱敏配置参考

以下是适配nopCommerce场景、可正常运行的挂载配置示例，省略了非核心的默认配置段：

location: <YOUR_ACA_REGION>
name: mynopcommerce-store-container-app
resourceGroup: <YOUR_RESOURCE_GROUP>
type: Microsoft.App/containerApps
properties:
  managedEnvironmentId: /subscriptions/<YOUR_SUB_ID>/resourceGroups/<YOUR_RESOURCE_GROUP>/providers/Microsoft.App/managedEnvironments/<YOUR_ACA_ENV_NAME>
  configuration:
    activeRevisionsMode: Single
    secrets:
    - name: azure-sql-connectionstring-52068
      value: <YOUR_AZURE_SQL_CONNECTION_STRING>
  template:
    containers:
    - name: mynopcommerce-store-container-app
      image: myregistry.azurecr.io/nopcommerce:2
      command: []
      env:
      - name: AZURE_SQL_CONNECTIONSTRING
        secretRef: azure-sql-connectionstring-52068
      resources:
        cpu: 0.25
        memory: 0.5Gi
      # 新增容器内挂载路径配置
      volumeMounts:
      - volumeName: nopcommerce-config-share
        mountPath: /app/Config # 对应容器内存放appsettings.json的配置目录
    scale:
      minReplicas: 1
      maxReplicas: 10
    # 新增卷关联配置
    volumes:
    - name: nopcommerce-config-share
      storageName: <YOUR_REGISTERED_STORAGE_NAME> # 第一步在ACA环境中注册的存储名称
      storageType: AzureFile

挂载注意事项

SMB文件共享挂载到容器时，会直接覆盖挂载路径下的原有文件，不要将挂载路径设置为容器内存放核心程序文件的根目录（如nopCommerce的/app根目录），否则会导致程序文件被覆盖、容器启动失败，仅挂载需要跨副本共享的子目录即可，比如配置目录/app/Config、上传文件目录/app/wwwroot/Uploads。
确保ACA环境和存储账户位于同一区域，存储账户的SMB 445端口没有被网络策略拦截，注册存储时填写的存储账户密钥、文件共享名称准确无误。

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