Mac M1运行docker compose启动容器报Function not implemented错误如何解决

• 核心为架构不兼容导致的系统调用缺失：你运行的.NET应用Docker镜像是x86_64架构版本，M1芯片属于arm64架构，Docker Desktop for Mac默认通过qemu模拟器转译运行x86架构容器
• qemu模拟器对.NET运行时依赖的inotify（Linux平台文件系统事件监控接口）系统调用支持不完全，而你的ASP.NET Core应用默认开启了配置文件热重载能力，依赖FileSystemWatcher调用inotify接口监控配置文件变更，调用失败后直接抛出未实现异常，最终触发进程崩溃。

方案1：使用适配arm64架构的.NET镜像（最优方案） #

• 直接在Dockerfile中更换基础镜像为官方支持多架构的.NET版本，.NET Core 3.1及以上的官方镜像均已兼容arm64架构，Docker会自动拉取和当前设备架构匹配的镜像版本，无需额外调整其他配置
• 若镜像为自行打包生成，可直接在M1设备上重新构建生成arm64版本，或使用buildx工具构建多架构通用镜像。

方案2：启用.NET轮询式文件监控（临时兼容方案，无需修改镜像代码） #

启动容器时添加环境变量DOTNET_USE_POLLING_FILE_WATCHER=1，强制.NET用轮询方式替代FileSystemWatcher监控文件变更，规避未实现的系统调用。
可直接在docker-compose.yml对应服务的配置块中添加：

services:
  你的服务名:
    environment:
      - DOTNET_USE_POLLING_FILE_WATCHER=1

也可在Dockerfile中提前写入环境变量：

ENV DOTNET_USE_POLLING_FILE_WATCHER=1

方案3：关闭配置文件热重载 #

如果你不需要运行时修改配置自动生效，可以在构建WebHost时关闭所有配置文件的reloadOnChange参数，从根源上避免触发FileSystemWatcher相关逻辑，代码示例如下：

WebHost.CreateDefaultBuilder(args)
    .ConfigureAppConfiguration((context, config) =>
    {
        // 清空默认添加的配置源
        config.Sources.Clear();
        // 手动添加配置文件，关闭重载开关
        config.AddJsonFile("appsettings.json", optional: false, reloadOnChange: false);
        config.AddJsonFile($"appsettings.{context.HostingEnvironment.EnvironmentName}.json", optional: true, reloadOnChange: false);
        // 其他配置源按实际需求添加
    })
    .UseStartup<Startup>();

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