发布ASP.NET Core应用到Azure Container Apps时遇MANIFEST UNKNOWN错误

• 手动指定固定镜像标签
  问题根源大概率是Visual Studio自动生成的时间戳标签在部署配置和实际镜像构建时出现了不一致。直接替换自动时间戳为固定标签：

  1. 打开项目属性的发布配置面板，找到「容器镜像设置」
  2. 将自动生成的时间戳标签改为固定值（比如latest或自定义版本号），重新执行发布

• 清理本地与发布缓存

  1. 打开命令行执行docker system prune -a，清理本地无用的镜像、容器及缓存文件
  2. 关闭Visual Studio，删除项目目录下的obj和bin文件夹，重启VS后重新发布

• 等待注册表镜像同步
  镜像推送完成后，Azure容器注册表的索引同步可能存在延迟，导致容器应用拉取时找不到刚推送的镜像：

  1. 发布完成后等待1-2分钟，再查看容器应用状态
  2. 确认注册表中目标镜像存在后，手动在容器应用配置里更新镜像标签为实际存在的版本

• 修改发布配置文件固定标签
  找到项目Properties/PublishProfiles目录下的发布配置文件（.pubxml），在<PropertyGroup>节点中添加固定标签配置：

  <DockerImageTag>my-app-v1</DockerImageTag>
  

  保存后重新发布，强制VS使用指定标签构建和推送镜像

• 手动用Docker CLI发布验证
  跳过VS自动流程，手动执行构建推送，排查是否为VS工具链问题：

  1. 构建镜像：docker build -t <你的注册表名称>.azurecr.io/<镜像名>:test-tag .
  2. 登录注册表：az acr login --name <你的注册表名称>
  3. 推送镜像：docker push <你的注册表名称>.azurecr.io/<镜像名>:test-tag
  4. 在Azure容器应用中手动指定使用test-tag镜像，验证是否能正常启动

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