M1 Mac上的.NET Testcontainers是否故障？有无解决办法？

环境信息 #

• 设备：2021款M1芯片MacBook Pro
• 系统：macOS Ventura 13.4
• Docker版本：Docker Desktop 4.19.0（Engine 23.0.5）
• .NET Testcontainers版本：3.2.0

问题重现 #

1. 创建控制台项目：dotnet new console --name HelloTestcontainers
2. 安装Testcontainers包：dotnet add package Testcontainers -v 3.2.0
3. 添加示例代码并编译，执行时在await container.StartAsync().ConfigureAwait(false);处抛出异常：

Unhandled exception. Docker.DotNet.DockerApiException: Docker API responded with status code=BadRequest, response={"message":"invalid mount config for type \"bind\": stat /host_mnt/Users/me/.docker/run/docker.sock: operation not supported"}

解决方案 #

1. 检查Docker Desktop文件共享配置 #

Docker需要权限访问宿主目录才能完成挂载操作：

• 打开Docker Desktop，进入「设置」→「Resources」→「File Sharing」
• 确认你的用户目录（例如/Users/me）已被勾选
• 点击「Apply & Restart」重启Docker后重试

2. 显式指定Docker Socket路径 #

M1 Mac上Docker Socket的默认路径可能和Testcontainers自动识别的路径不匹配，手动指定正确路径：
修改ContainerBuilder配置，添加.WithDockerEndpoint("unix:///var/run/docker.sock")：

using System.Diagnostics;
using DotNet.Testcontainers.Builders;

var container = new ContainerBuilder()
  .WithImage("testcontainers/helloworld:1.1.0")
  .WithPortBinding(8080, true)
  .WithDockerEndpoint("unix:///var/run/docker.sock") // 显式指定Socket路径
  .Build();

await container.StartAsync().ConfigureAwait(false);

// ... 剩余代码

也可以通过设置环境变量DOCKER_HOST=unix:///var/run/docker.sock来全局配置。

3. 升级Testcontainers版本 #

v3.2.0可能存在M1环境下的兼容性问题，尝试升级到最新稳定版：
执行命令：dotnet add package Testcontainers（若省略版本报错，可手动指定最新版本号，如-v 3.7.0）

4. 验证Docker虚拟化设置 #

• 进入Docker Desktop「设置」→「Features in development」
• 尝试切换「Use Rosetta for x86/amd64 emulation」的状态（开启/关闭），重启Docker后重试

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