Mac系统更新后React项目npm start启动报错求助

1. 先获取真实的底层报错 #

当前npm日志只记录了外层脚本运行失败，完全没有暴露react-scripts本身启动崩溃的具体原因，首先跳过npm的脚本包装环节，直接运行本地安装的react-scripts，获取完整错误输出：

• 在项目根目录执行./node_modules/.bin/react-scripts start
• 把这条命令的完整输出记录下来，绝大多数场景下这一步就能看到真实原因（比如权限不足、架构不兼容、依赖缺失的明确提示）

2. 排查M系列Mac的架构兼容问题 #

从你的日志路径/opt/homebrew可以判断你用的是M芯片的Mac，老版本node（尤其是2022年之前安装的）大概率是x86_64转译版本，系统更新后很容易出现Rosetta2转译失效的问题，导致子进程spawn直接失败：

• 执行file $(which node)检查架构：
  • 如果输出包含x86_64而非arm64，说明是转译运行的node
  • 解决方式二选一：
    • 给终端App开启Rosetta运行权限，再重新执行项目启动命令
    • 卸载现有node，用原生arm模式重装对应版本：arch -arm64 brew uninstall node && arch -arm64 brew install node@15
  • 更推荐直接升级到兼容新系统的LTS版本node，避免后续更多兼容问题

3. 修复系统更新导致的Homebrew目录权限问题 #

macOS大版本更新后经常会重置/opt/homebrew目录的权限，导致node没有权限拉起子进程：

• 先执行ls -l $(which node)确认权限位，正常应该有可执行权限（显示为rwxr-xr-x）
• 如果权限异常，执行sudo chmod -R 755 /opt/homebrew/Cellar/node/修复node目录的全部权限

4. 排查PATH环境变量冲突 #

系统更新后可能会在全局路径配置（/etc/paths）或者shell配置文件（_/.zshrc、/.bash_profile）里插入其他node版本的路径，导致npm运行时混用不同版本的node，引发兼容性崩溃：

• 执行which node、which npm确认输出路径全部是/opt/homebrew下的，没有混进系统自带node、nvm版本或者其他路径的node
• 如果有多余的node路径，把Homebrew的bin路径（export PATH="/opt/homebrew/bin:$PATH"）放在shell配置文件的最顶部，保存后重启终端再测试

5. 排查老版本npm的已知路径bug #

你使用的npm@7.5.4是2021年的老版本，存在已知bug：当项目路径包含空格、中文或特殊字符时，会直接导致脚本spawn失败

• 先把整个项目文件夹移到纯英文无特殊符号的路径下，再执行启动命令测试

内容的提问来源于stack exchange，提问作者NRoscoe