SST项目在M2 Macbook Pro上安装x64版Bun的兼容性问题解析

问题背景

在基于SST框架部署React应用的过程中，开发者在M2芯片的Macbook Pro上遇到了一个典型的架构兼容性问题。当执行npx sst dev命令时，系统错误地尝试下载并安装x64架构版本的Bun运行时环境，而非预期的arm64版本，导致安装失败。

技术分析

1. 架构识别机制

M系列Mac设备采用arm64架构，但通过Rosetta 2转译层可以运行x64应用。问题发生时，SST的依赖管理系统错误地将设备识别为传统x64架构环境。这通常源于以下几个技术环节：

• 环境变量未正确传递架构信息
• Node版本管理器(nvm)配置异常
• Shell环境残留旧版配置

2. SST的依赖管理流程

SST框架在初始化时会执行以下关键步骤：

1. 检查并下载必要工具链（Pulumi/Bun）
2. 构建项目配置
3. 安装平台依赖
4. 初始化部署环境

其中Bun的下载链接硬编码了架构标识（如bun-darwin-x64），正常情况下应通过运行时检测自动选择正确版本。

解决方案

1. 环境重置方案

1. 清理Shell配置文件（如.zshrc/.bash_profile）
2. 移除nvm及相关Node版本
3. 重新安装arm64原生Node环境
4. 验证架构识别：node -p "process.arch"应返回arm64

2. 临时解决方案

在确认环境问题前，可通过强制指定Bun版本临时解决：

export BUN_VERSION=1.1.30-darwin-arm64
npx sst dev

最佳实践建议

1. 环境隔离：使用工具如asdf管理多架构运行时
2. 依赖验证：新设备初始化时先验证基础工具链
3. 日志分析：关注SST输出的level=INFO日志中的架构信息
4. 缓存清理：遇到类似问题时清除~/Library/Application Support/sst缓存

经验总结

这类架构识别问题在M系列Mac上较为常见，根本原因是工具链对Rosetta 2环境的适应不足。开发者应当：

• 优先使用原生arm64构建的工具链
• 保持开发环境的一致性
• 在团队协作时明确设备架构要求

通过系统性的环境配置管理，可以有效避免此类兼容性问题，提升基于SST框架的开发体验。