n8n在2.46.0之后的部分版本中，曾因平台专用原生依赖被列为硬依赖，导致npm全局安装报ebadplatform。对应修补版本为稳定分支2.46.6及以后、测试分支2.47.2及以后，排查时应先确认是否命中这一具体问题。
错误来自依赖平台不匹配
EBADPLATFORM表示某个依赖声明支持的平台与当前系统不一致。本次记录涉及Linux musl的不同架构绑定，npm可能在并不匹配的环境中尝试安装它们，从而中断安装。判断时应查看错误中具体的软件包、CPU架构与libc要求，而不只看最后一行错误码。同样的错误码也可能由其他依赖引起，不能一概归入n8n这次版本问题。
选择包含修补的对应分支
原计划使用稳定版时，应选择稳定分支中已经包含修补的版本；不要为了安装成功而无意切到测试通道。下面以对应稳定修补版演示指定版本安装：
npm install -g n8n@2.46.6
实际使用时还应核对所选版本的Node.js要求和后续维护状态。已有运行实例应先保存工作流、凭据和相关数据，再按部署方式执行升级，不把全局重装当成数据备份。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
n8n文档中的npm全局安装与指定版本方式
安装后核对程序与原始错误
安装结束后检查版本：
n8n --version
确认读取的是预期安装路径中的程序，再检查启动和已有工作流。版本号正确且原来的平台依赖错误消失，才说明本次安装问题得到对应处理。如果仍报EBADPLATFORM，应继续记录具体依赖名称和系统架构，不使用强制忽略平台检查来掩盖不兼容。依赖绑定错误修好，也不代表其他节点或模型接口故障会同时解决。
