NexRender在M1 Mac上运行出现SIGILL错误的解决方案

在M1/M2芯片的Mac设备上使用NexRender进行After Effects自动化渲染时，可能会遇到一个棘手的问题：渲染过程中出现"aerender.exe failed to render the output into the file due to an unknown reason"错误。本文将深入分析这一问题的成因，并提供详细的解决方案。

问题现象

当用户尝试通过NexRender CLI执行渲染任务时，虽然直接使用aerender命令行工具可以正常工作，但通过NexRender调用时却会失败。错误日志中会显示"illegal instructions: 4"（非法指令）错误，这是典型的处理器架构不匹配导致的信号中断。

根本原因

这个问题源于Node.js运行环境的架构不匹配。具体表现为：

1. Node.js进程运行在Rosetta 2转译的x86_64模式下
2. Adobe After Effects的aerender二进制文件是原生ARM64架构
3. 当x86_64进程尝试调用ARM64二进制时，系统会抛出SIGILL信号

解决方案

要解决这个问题，需要确保整个调用链都使用一致的架构：

1. 检查当前Node.js架构 在终端执行以下命令检查Node.js运行模式：

   node -e 'console.log(process.arch)'
   

   正常应该输出arm64，如果输出x64则说明运行在Rosetta转译模式。

2. 重新安装Node.js 如果发现Node.js运行在x64模式，需要完全卸载并重新安装：

   # 先卸载现有Node.js
   sudo rm -rf /usr/local/{bin/{node,npm},lib/node_modules/npm,lib/node,share/man/*/node.*}
   
   # 下载并安装ARM64版本的Node.js
   # 注意：确保终端没有运行在Rosetta模式下
   

3. 验证安装结果 重新安装后，再次检查架构：

   node -e 'console.log(process.arch)'
   

   确认输出为arm64。

4. 重新安装NexRender 在确认Node.js架构正确后，重新安装NexRender：

   npm install -g @nexrender/cli
   

预防措施

为了避免类似问题，建议：

1. 在M1/M2 Mac上安装软件时，始终确保终端没有运行在Rosetta模式下
2. 优先选择原生支持ARM64的软件版本
3. 定期检查关键工具的架构兼容性

技术背景

Apple Silicon Mac使用ARM64架构处理器，但为了兼容性提供了Rosetta 2转译层，允许运行x86_64应用程序。然而，当x86_64进程尝试调用ARM64二进制时，或者反过来，都可能产生架构冲突。

Adobe After Effects 2024及更高版本已原生支持ARM64架构，其aerender工具也是原生ARM64二进制。因此，调用它的进程也应该是ARM64架构，否则就会出现本文描述的SIGILL错误。

通过确保整个工具链架构一致，可以避免这类兼容性问题，充分发挥M1/M2芯片的性能优势。