.NET Aspire部署PostgreSQL到Azure时出现VolumeMountFailure错误

问题背景 #

使用azd up部署包含PostgreSQL的.NET Aspire项目到Azure后，PostgreSQL容器处于pending状态，控制台日志显示VolumeMountFailure，具体错误为mount error(2): No such file or directory（基于CIFS挂载）。本地运行正常，替换为SQL Server时卷挂载正常，Azure存储账户和文件共享已创建。

原因分析 #

PostgreSQL容器默认数据目录/var/lib/postgresql/data需要由postgres用户拥有权限，但Azure Container Apps挂载的CIFS卷默认权限为root用户所有，导致PostgreSQL进程无法访问目录；此外，自动创建的卷挂载路径可能存在隐式配置问题，与SQL Server的目录权限模型不同。

解决方案 #

1. 显式配置卷挂载并修正目录权限 #

修改AppHost中的PostgreSQL配置，添加启动命令先修正数据目录权限：

var postgresPassword = builder.AddParameter("postgresql-password", secret: true);
var db = builder.AddPostgres("postgres", password: postgresPassword)
    .WithDataVolume()
    // 显式指定卷挂载路径，添加权限修正命令
    .WithVolumeMount("postgres-data", "/var/lib/postgresql/data")
    .WithCommand("bash", "-c", "chown -R postgres:postgres /var/lib/postgresql/data && docker-entrypoint.sh postgres")
    .WithPgWeb()
    .AddDatabase("db");

该命令在容器启动前将数据目录的所有权切换为postgres用户，确保PostgreSQL进程能正常访问挂载的卷。

2. 验证存储共享配置 #

• 登录Azure门户，进入对应存储账户的文件共享，确认postgres-data共享存在，且无路径拼写错误
• 检查存储账户的访问密钥是否有效，确保Azure Container Apps的卷配置引用了正确的存储账户和密钥

3. 切换为托管Azure PostgreSQL服务 #

若容器卷问题持续，可直接使用托管的Azure Database for PostgreSQL替代容器部署，简化配置并提升稳定性：

var postgresPassword = builder.AddParameter("postgresql-password", secret: true);
var db = builder.AddAzurePostgres("postgres", password: postgresPassword)
    .AddDatabase("db");

验证步骤 #

1. 执行azd down清理现有Azure资源，避免残留配置干扰
2. 重新执行azd up部署项目，观察PostgreSQL容器启动状态

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