MikroORM在Apple Silicon芯片MacOS环境下的MSSQL测试问题分析与解决方案

问题背景

在Apple Silicon芯片（M1/M2）的MacOS设备上，使用较新版本的Docker（4.33.0及以上）运行MikroORM测试套件时，所有依赖MSSQL的测试用例都会失败。这个问题源于Docker底层架构与Microsoft SQL Server镜像之间的兼容性问题。

技术原理分析

平台架构差异

现代Mac设备采用ARM架构的Apple Silicon芯片（arm64），而传统服务器和PC通常使用x86架构（amd64）。Docker在MacOS上通过虚拟化技术运行Linux容器，最新版本的Docker For Mac默认使用Linux 6.7.0+内核。

MSSQL镜像的特殊情况

Microsoft提供的azure-sql-edge镜像虽然同时支持amd64和arm64平台，但存在两个关键问题：

1. 微软已于2023年9月停止对arm64架构的azure-sql-edge支持，导致只能拉取到两年前的旧版本镜像
2. 旧版MSSQL存在一个已知缺陷：在Linux 6.7.0+内核上运行时会导致崩溃

问题根源

当在Apple Silicon设备上运行测试时：

1. Docker会自动选择arm64平台的azure-sql-edge镜像
2. 由于微软已停止更新，只能获取到包含内核兼容性问题的旧版本
3. 容器启动后因内核不兼容而崩溃，导致依赖MSSQL的测试全部失败

解决方案

强制使用amd64平台

通过修改docker-compose.yml配置，强制Docker拉取amd64平台的镜像：

services:
  mssql:
    platform: linux/amd64
    image: mcr.microsoft.com/azure-sql-edge:latest

启用Rosetta 2转译

在Docker For Mac设置中启用Rosetta 2支持，使Apple Silicon设备能够运行amd64架构的容器：

1. 打开Docker Desktop设置
2. 进入"Features in development"选项卡
3. 勾选"Use Rosetta for x86/amd64 emulation on Apple Silicon"

实施建议

对于开发团队：

1. 将平台限制加入项目docker-compose文件
2. 在项目文档中明确说明Apple Silicon环境下的特殊配置要求

对于个人开发者：

1. 确保Docker For Mac版本在4.33.0以上
2. 按照上述方案修改配置并启用Rosetta支持
3. 重建测试容器以确保使用正确的镜像版本

总结

这个问题展示了跨平台开发中常见的架构兼容性挑战。通过理解底层技术原理，我们可以找到有效的解决方案。对于Apple Silicon用户，强制使用amd64平台并启用Rosetta转译是目前最可靠的解决方法，直到微软恢复对arm64平台的支持或提供更新的兼容镜像。

这种方案不仅适用于MikroORM测试环境，也可作为其他需要在Apple Silicon设备上运行x86架构数据库容器的参考方案。