Node.js升级至18版本后API调用失败，返回500内部服务器错误求助

故障定位 #

核心错误是TypeError: Failed to parse URL from，说明使用@pnp/sp库发起请求时，传递的URL为空或格式无效。Node.js 18更换了内置的undici作为HTTP客户端，对URL解析的校验比旧版本严格很多，而当前使用的@pnp旧版本未适配这个变化，导致原本能“兼容”的无效URL直接触发报错。报错栈指向@pnp/common-commonjs/net.js的mergeHeaders方法，说明请求初始化阶段就因URL问题失败。

解决方法 #

• 升级@pnp依赖包
  旧版@pnp/sp（尤其是v2.x以下版本）与Node.js 18存在兼容性问题，直接更新到最新稳定版：

  yarn upgrade @pnp/sp-commonjs @pnp/common-commonjs --latest
  

  使用npm的话执行：

  npm update @pnp/sp-commonjs @pnp/common-commonjs
  

• 检查SharePoint站点URL配置
  确认代码中初始化SPHttpClient时传入的站点URL有效，避免为空或格式错误：

  // 错误示例：空URL导致解析失败
  const sp = spfi("");
  // 正确示例：传入真实的SharePoint站点地址
  const sp = spfi("https://your-sharepoint-site.sharepoint.com/sites/your-team-site");
  

• 排查文件夹路径的URL拼接逻辑
  检查获取文件夹结构的API调用代码，确保拼接的服务器相对路径格式正确：

  // 错误示例：空路径导致URL不完整
  const folderRequestUrl = `${siteUrl}/_api/web/getfolderbyserverrelativeurl('')`;
  // 正确示例：传入有效的文件夹相对路径
  const folderRequestUrl = `${siteUrl}/_api/web/getfolderbyserverrelativeurl('/Shared Documents/Target-Folder')`;
  

• 临时兼容方案（不推荐长期使用）
  如果暂时无法升级依赖，可通过环境变量禁用Node.js 18的新fetch行为：

  NODE_OPTIONS=--no-experimental-fetch
  

  优先推荐升级依赖解决根本问题，此方案仅作临时救急。

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