Docker Desktop for Mac中Airflow Webserver反复重启的原因与解决办法

故障现象 #

• 严格按照Apache Airflow官方Docker部署快速入门流程完成环境准备，全安装流程无任何报错
• 执行 docker-compose up 启动服务时，调度器、任务执行器、元数据库、Triggerer等其余所有组件均可正常稳定运行
• 仅Webserver服务启动后反复触发故障重启循环，查看容器日志可定位到对应的进程异常退出信息
• 逐一排查过镜像版本不兼容、配置文件挂载错误、本地端口占用、文件权限不足等常见配置类问题，未发现匹配故障的异常配置

根因定位 #

• 问题核心原因为 Docker Desktop for Mac 默认的虚拟机内存分配额度，无法满足Airflow Webserver组件的运行资源要求
  Mac版Docker Desktop通过内置轻量虚拟机承载所有容器运行环境，默认初始分配的内存通常仅为2GB左右。Webserver启动阶段需要完成元数据表初始化、静态资源加载、应用服务全链路预热流程，内存峰值很容易超过默认额度，触发系统OOM机制杀掉Webserver进程，最终表现为容器反复重启。

解决步骤 #

• 打开Docker Desktop for Mac设置面板，进入资源配置板块
• 调高虚拟机的可用内存额度，建议最低配置4GB以上内存
• 保存配置并重启Docker Desktop，使新的内存分配策略完全生效
• 回到Airflow部署目录，清理当前处于异常状态的容器：执行 docker-compose down
• 重新启动整套Airflow服务：执行 docker-compose up
• 等待所有组件完成启动流程后访问Webserver端口，验证服务功能，此时所有组件均可正常运行

补充说明：如果调高内存配置后Webserver仍存在重启问题，可额外排查是否存在日志打印量过载、挂载的本地DAG目录包含超大文件/复杂代码导致的内存占用过高问题。

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