Vagrant下docker-compose报段错误及SSH非零退出排查

段错误（Segmentation fault）是程序触发非法内存访问导致的崩溃，结合Vagrant自动配置Docker环境的常见场景，按以下顺序排查可快速定位问题：

• 第一优先级：验证docker-compose二进制文件的完整性
  这类崩溃绝大多数不是业务配置问题，而是二进制文件本身异常导致：
  1. 登录Vagrant虚拟机后执行uname -m，确认系统架构是x86_64还是aarch64，避免出现下载了架构不匹配的compose二进制的问题（比如在ARM架构的虚拟机里放置x86版本的compose，一运行就会直接段错误）
  2. 执行ls -lh /usr/local/bin/docker-compose-1.24.1，确认文件大小正常——完整的1.24.1版本compose二进制大小约15M，要是只有几K甚至更小，说明之前Vagrant provision阶段下载中断、文件写入不完整，运行必然崩溃
  3. 执行chmod +x /usr/local/bin/docker-compose-1.24.1补全执行权限，部分场景下权限缺失也会触发这类无明确提示的崩溃
• 第二优先级：排查Vagrant共享目录的读取异常
  你的compose配置存放在/vagrant/路径下，这是Vagrant默认把本地项目目录映射到虚拟机的共享路径，这类路径和本地文件系统的交互存在不少兼容问题：
  1. 先把配置文件复制到虚拟机本地非共享路径验证：执行cp /vagrant/docker-compose.yml ~/test-compose.yml，再手动运行/usr/local/bin/docker-compose-1.24.1 -f ~/test-compose.yml config，如果这时候不报错，说明是共享目录的文件映射问题——尤其要注意本地项目存在同步盘加密、Windows下NTFS路径带特殊字符、共享目录驱动版本过旧的情况
  2. 检查yml文件的编码，不要保存为带BOM的UTF-8或者含乱码的格式，老版本compose的解析器遇到不可识别的二进制内容时，很容易触发内存越界崩溃，不会给出正常的语法报错
• 第三优先级：排查版本兼容问题
  docker-compose 1.24.1是2019年发布的老版本，如果Vagrant环境里安装的是近2年更新的Docker Engine版本，二者通信协议存在不兼容，老版本compose调用Docker daemon接口时可能触发非法内存访问。可以执行docker version查看Docker daemon版本，如果版本发布时间远晚于compose 1.24.1的发布时间，就需要替换为和Docker版本匹配的compose工具。

快速定位技巧：不要直接执行带up -d的全量启动命令，分步执行缩小故障范围：

• 先执行 /usr/local/bin/docker-compose-1.24.1 version，如果这步就报段错误，直接可以确定是二进制文件本身的问题，和配置、Docker服务无关
• 如果version命令能正常输出版本号，再执行config命令检查配置读取环节，这步崩溃就是配置文件或者共享目录的问题
• 如果config命令能正常输出配置，再执行ps命令检查和Docker daemon的通信环节，这步崩溃就是版本兼容问题

新手常踩的坑 #

• 写Vagrant provision脚本下载compose时，curl命令漏加跟随重定向参数，导致下载下来的是网页跳转内容而非真正的二进制文件，这种情况运行必然段错误
• 不要把docker-compose二进制放在/vagrant这类共享路径下运行，必须放在虚拟机本地磁盘路径调用

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