kerl项目在macOS Sonoma上编译Erlang的故障排查指南

问题现象

在macOS Sonoma 14.2系统上，使用asdf安装最新版Erlang/OTP(26.2.3)时，编译过程在megaco_flex_scanner模块处反复失败。错误表现为两种形式：

1. 直接报错Error 1并终止编译
2. 添加--without-javac配置选项后，出现Segmentation fault: 11和Error 139

错误分析

megaco_flex_scanner是Erlang/OTP中MEGACO协议栈的Flex扫描器组件，负责协议消息的词法分析。编译失败通常表明：

1. 系统环境存在冲突的Erlang相关配置
2. 编译器工具链不兼容
3. 系统架构模式不正确(在Apple Silicon Mac上需要确认使用ARM模式)

解决方案

经过排查，发现该问题是由于残留的环境变量导致的。具体解决步骤如下：

1. 清理环境变量：

   • 检查并清理.bash_login、.bash_profile或.zshrc等shell配置文件
   • 移除所有与旧版Erlang相关的环境变量设置

2. 验证终端模式：

   • 确保终端运行在原生ARM模式(可通过uname -m确认输出为arm64)

3. 全新shell会话：

   • 在清理环境后，开启全新的终端会话再进行安装

预防措施

为避免类似问题，建议：

1. 在安装新版Erlang前，彻底卸载旧版本
2. 使用环境管理工具(如direnv)隔离不同项目的环境
3. 定期检查并清理shell启动文件中的过期配置

技术背景

megaco_flex_scanner是Erlang/OTP中一个特殊的组件，它：

• 使用Flex生成词法分析器
• 需要特定的编译标志如-DENABLE_MEGACO_FLEX_SCANNER
• 对Erlang虚拟机版本和编译工具链较为敏感

在Apple Silicon平台上，混合架构环境更容易引发此类编译问题，因此保持环境纯净尤为重要。

总结

通过系统性地清理环境变量和验证系统配置，可以解决大多数在macOS上使用kerl编译Erlang时遇到的问题。这也提醒我们，在开发环境中，良好的配置管理习惯可以避免许多难以诊断的问题。