安装AWS S3 SDK后出现可选链操作符语法错误求助

问题描述 #

安装AWS S3 SDK后运行项目，触发SyntaxError: Unexpected token '.'错误，指向SDK的S3Client.js文件中的可选链（?.）和空值合并（??）语法，已尝试升级Node.js到18版本、安装Babel相关插件，但问题未解决。错误栈如下：

bodyLengthChecker: config?.bodyLengthChecker ?? util_body_length_node_1.calculateBodyLength,
                              ^
SyntaxError: Unexpected token '.'
    at wrapSafe (internal/modules/cjs/loader.js:915:16)
    at Module._compile (internal/modules/cjs/loader.js:963:27)
    at Object.Module._extensions..js (internal/modules/cjs/loader.js:1027:10)
    at Module.load (internal/modules/cjs/loader.js:863:32)
    at Function.Module._load (internal/modules/cjs/loader.js:708:14)
    at Module.require (internal/modules/cjs/loader.js:887:19)
    at require (internal/modules/cjs/helpers.js:74:18)
    at Object.<anonymous> (/home/ubuntu/VGS/node_modules/@aws-sdk/client-s3/dist-cjs/S3Client.js:19:25)

排查与解决方案 #

1. 确认实际运行的Node.js版本 #

Node.js 14+已原生支持可选链和空值合并语法，但如果终端实际运行的版本不是18，会触发该错误。执行以下命令验证：

node -v

• 若输出不是v18.x.x，说明版本切换未生效：
  • 使用nvm的话，执行nvm use 18临时切换，或nvm alias default 18设置默认版本；
  • 若通过其他方式安装Node，检查系统PATH是否优先指向Node 18的安装目录。

2. 升级/降级AWS S3 SDK版本 #

部分SDK版本的编译产物可能存在兼容性问题，尝试切换到稳定版本：

• 升级到最新稳定版：

  npm install @aws-sdk/client-s3@latest
  

• 若最新版仍有问题，尝试降级到已知兼容Node 18的版本（如3.422.0）：

  npm install @aws-sdk/client-s3@3.422.0
  

3. 清理包管理器缓存并重装依赖 #

缓存的旧SDK编译文件可能导致问题，执行以下步骤清理重装：

npm：

npm cache clean --force
rm -rf node_modules package-lock.json
npm install

yarn：

yarn cache clean
rm -rf node_modules yarn.lock
yarn install

4. 检查项目的Node版本限制配置 #

• 查看项目根目录的.nvmrc文件，确保内容为18；
• 检查package.json中的engines字段，确认Node版本要求为>=18，若存在版本限制且与当前运行版本不符，修改后重新安装依赖。

5. 排查Babel配置干扰 #

若项目配置了Babel转译node_modules，可能导致SDK代码被错误处理：

• 打开项目的babel.config.js或.babelrc，确保exclude数组包含node_modules：

  module.exports = {
    exclude: /node_modules/,
    // 其他配置...
  };
  

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