Node.js调用Google Drive API报dlfcn_load认证错误解决方案

你遇到的error:25066067:DSO support routines:dlfcn_load:could not load the shared library报错和Drive业务逻辑无关，是运行环境依赖兼容问题，同时你现有代码和服务账号配置存在额外问题，即使解决环境报错也无法正常访问个人Drive资源，按以下步骤逐一修复：

1. 优先解决DSO动态库加载错误 #

该错误是Node.js 17+版本默认搭载的OpenSSL 3.0与旧版谷歌SDK依赖的OpenSSL 1.x接口不兼容导致，按优先级尝试以下方案：

• 升级依赖到兼容版本
  先将项目内谷歌相关SDK升级到最新稳定版，新版已原生适配OpenSSL 3.0：

  npm install googleapis@latest google-auth-library@latest
  

• 临时兼容启动（升级依赖后仍报错时使用）
  启动脚本时添加Node运行参数，启用旧版OpenSSL兼容模式：

  # Linux/macOS
  NODE_OPTIONS=--openssl-legacy-provider node 你的脚本文件名.js
  

  # Windows CMD
  set NODE_OPTIONS=--openssl-legacy-provider
  node 你的脚本文件名.js
  

• Linux系统补充兼容库
  Debian/Ubuntu系系统如果以上方案无效，手动安装OpenSSL 1.1兼容库：

  sudo apt update && sudo apt install libssl1.1
  

2. 修复服务账号访问个人Drive的权限配置 #

服务账号是独立的虚拟账号，默认只能访问自身所属的隔离存储空间，没有权限访问你个人Google Drive的资源，必须完成以下配置：

• 打开Google Cloud控制台，进入对应服务账号的详情页，复制服务账号邮箱（格式为xxx@你的项目id.iam.gserviceaccount.com）
• 打开你个人Google Drive中要操作的目标文件夹，点击右上角「共享」，将上述服务账号邮箱添加为协作者，权限设置为「编辑」后保存
  注意：如果不完成文件夹共享步骤，服务账号调用接口会直接返回403权限错误，无法访问任何你个人Drive下的资源。
  额外校验：确认项目根目录的credentials.json是服务账号的JSON密钥（在服务账号详情页「密钥」栏创建下载），不要误用OAuth 2.0客户端的密钥文件，两者格式不通用会直接触发认证失败。

3. 修正代码逻辑问题 #

你贴的代码存在参数类型错误、逻辑缺失问题，调整后的可运行版本如下：

const { google } = require('googleapis');

async function createFile({ folderId, title, data }) {
  try {
    const auth = new google.auth.GoogleAuth({
      keyFile: "credentials.json",
      // scopes必须传数组类型，字符串类型在部分SDK版本会触发认证异常
      scopes: ["https://www.googleapis.com/auth/drive"],
    });

    const drive = google.drive({ version: "v3", auth });

    // 先测试文件列表读取，确认权限链路正常
    const listRes = await drive.files.list({
      pageSize: 10,
      fields: "nextPageToken, files(id, name)",
    });
    console.log('文件列表读取成功：', listRes.data.files);

    // 补全创建文件逻辑
    const createRes = await drive.files.create({
      requestBody: {
        name: title,
        parents: [folderId] // 绑定目标文件夹ID
      },
      media: {
        body: data // 传入要写入的文件内容
      },
      fields: 'id, name'
    });
    console.log('文件创建成功，文件ID：', createRes.data.id);
    return createRes.data;
  } catch (err) {
    console.error('接口调用异常：', err);
    throw err;
  }
}

// 调用示例
// createFile({
//   folderId: '替换为你的目标文件夹ID',
//   title: '测试文件.txt',
//   data: '这是测试文件内容'
// })

代码调整点：

• 修正scopes参数类型为数组，符合SDK要求
• 将回调风格写法改为async/await，统一异常捕获
• 补全了创建文件的核心逻辑，原代码仅实现了文件列表查询
• 明确指定接口返回字段，减少不必要的数据传输

验证顺序 #

1. 完成npm依赖升级
2. 确认服务账号已被添加为目标Drive文件夹的编辑协作者
3. 替换代码中folderId为实际的文件夹ID
4. 用兼容模式启动脚本，先确认文件列表能正常返回，再测试文件创建功能

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