GitLab CI/CD部署React至Debian11时serve命令抛出语法错误

核心原因 #

你遇到的语法错误是因为远程执行serve命令时，使用的是Debian 11系统默认的旧版本Node.js（Debian 11默认Node版本为12.x，不支持ES2020的可选链操作符?.和空值合并操作符??）。虽然你用nvm在服务器上安装了19.4.0版本，但流水线通过ssh执行命令时，默认不会加载nvm的环境变量（nvm的配置通常只在交互式shell中生效），导致实际调用的还是系统自带的旧Node版本。

解决方案 #

1. 远程命令中手动加载nvm环境

修改流水线中的script步骤，在执行serve前先加载nvm的环境配置并指定使用19.4.0版本：

script:
  - echo "Deploying application..."
  # 注意修正变量名拼写错误：PROEJCT_PATH → PROJECT_PATH
  - ssh $SSH_USER@$SSH_IP "source ~/.nvm/nvm.sh && nvm use 19.4.0 && cd $PROJECT_PATH/$PROJECT_DIRECTORY_NAME && serve -s build"
  - echo "Application successfully deployed."

注：如果nvm安装路径不是~/.nvm，请替换为实际路径（可在服务器上执行which nvm查看）。

2. 配置服务器默认Node版本（可选，简化命令）

在Debian服务器上执行以下命令，将19.4.0设为默认Node版本：

nvm alias default 19.4.0

之后远程命令可以简化为：

ssh $SSH_USER@$SSH_IP "source ~/.nvm/nvm.sh && cd $PROJECT_PATH/$PROJECT_DIRECTORY_NAME && serve -s build"

3. 验证远程Node版本（排查用）

如果不确定问题是否由版本导致，可以在流水线中添加测试命令，查看远程执行时的Node版本：

script:
  - ssh $SSH_USER@$SSH_IP "node -v"
  # 后续部署命令...

如果输出是v12.x.x之类的旧版本，就确认了环境变量未加载的问题。

额外注意点 #

• 你流水线中的变量名PROEJCT_PATH存在拼写错误，应改为PROJECT_PATH，否则会导致路径跳转失败。

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