Docker Compose运行.NET应用遇System.IO.IOException异常求助

核心原因 #

在Apple M1（arm64架构）设备上运行x86架构的Debian容器时，QEMU模拟层无法支持.NET FileSystemWatcher依赖的Linux inotify文件系统事件机制，从而触发System.IO.IOException: Function not implemented异常。你之前的代码仅配置了Kestrel参数，未触及配置系统的文件变更监控逻辑，因此无法解决问题。

解决方案 #

1. 使用ARM64架构的.NET镜像（优先推荐） #

避免QEMU模拟带来的兼容性问题，直接使用适配arm64的.NET基础镜像。例如，如果你的应用基于.NET 6，将Dockerfile中的基础镜像替换为：

# 替换为对应.NET版本的arm64镜像
FROM mcr.microsoft.com/dotnet/aspnet:6.0-buster-slim-arm64v8

Docker Desktop会自动拉取arm64架构的镜像，无需额外配置。

2. 禁用配置文件的自动重载监控 #

如果必须使用x86镜像，可通过禁用配置系统的文件变更监控来绕过FileSystemWatcher的调用。修改CreateHostBuilder方法，关闭配置源的ReloadOnChange属性：

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureAppConfiguration((context, configBuilder) =>
        {
            // 遍历所有文件配置源，关闭自动重载
            foreach (var source in configBuilder.Sources.OfType<FileConfigurationSource>())
            {
                source.ReloadOnChange = false;
            }
        })
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.ConfigureKestrel(options =>
            {
                // gRPC endpoint listening on port 5001.
                // rest endpoint listening on port 80
            });

            webBuilder.UseStartup<Startup>();
        });

该操作会阻止.NET配置系统创建FileSystemWatcher监听配置文件变化，从根源避免异常。

3. 检查Docker Compose卷挂载配置 #

如果你的Compose配置中挂载了本地macOS目录到容器内，确保使用Docker Desktop的原生卷而非直接绑定挂载（绑定挂载可能导致文件系统事件无法正常传递）。例如：

services:
  your-app:
    volumes:
      # 使用命名卷替代直接目录绑定
      - app-data:/home/app-name
volumes:
  app-data:

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