NextJS中如何设置GOOGLE_APPLICATION_CREDENTIALS指向文件路径？

问题根源 #

Google Auth库要求GOOGLE_APPLICATION_CREDENTIALS指向绝对路径，相对路径会因为Node.js进程的工作目录（cwd）与预期不符而无法正确解析，这就是你在.env.local里设置相对路径无效的核心原因。另外你的代码存在异步流程问题：直接调用RequestToken()后立即返回响应，此时data还未被赋值，会导致返回空数据。

开发环境解决方案 #

方案1：动态生成绝对路径（推荐） #

在代码里将相对路径转换为绝对路径，避免依赖环境变量的硬编码路径：

import { NextApiRequest, NextApiResponse } from 'next';
import { GoogleAuth } from 'google-auth-library';
import path from 'path';
import { fileURLToPath } from 'url';

export default async function handler(
  req: NextApiRequest, 
  res: NextApiResponse
){
  // 解决ES模块下__dirname缺失的问题
  const __filename = fileURLToPath(import.meta.url);
  const __dirname = path.dirname(__filename);
  // 拼接凭证文件的绝对路径（假设credentials.json在项目根目录）
  const credentialsPath = path.join(process.cwd(), 'credentials.json');
  // 动态设置环境变量
  process.env.GOOGLE_APPLICATION_CREDENTIALS = credentialsPath;

  let data: any;
  const auth = new GoogleAuth();
  const targetAudience = 'cloud_function_url';
  const url = targetAudience;

  try {
    console.info(`request ${url} with target audience ${targetAudience}`);
    const client = await auth.getIdTokenClient(targetAudience);
    const response = await client.request({ url });
    console.info(response.data);
    data = response.data;
    res.status(200).json({ data });
  } catch (error) {
    console.error((error as Error).message);
    res.status(500).json({ error: (error as Error).message });
  }
}

方案2：在.env.local中设置绝对路径 #

直接在.env.local里写凭证文件的完整绝对路径：

# Mac/Linux示例
GOOGLE_APPLICATION_CREDENTIALS=/Users/yourname/your-project/credentials.json

# Windows示例
GOOGLE_APPLICATION_CREDENTIALS=C:\Users\yourname\your-project\credentials.json

这种方式需要每个开发人员根据本地路径修改，灵活性较差。

生产环境解决方案 #

部署到Google Cloud服务（Cloud Run、App Engine等） #

无需手动设置GOOGLE_APPLICATION_CREDENTIALS，平台会自动为应用分配默认服务账号身份，直接使用即可。

部署到第三方平台（Vercel、Netlify等） #

这类平台不支持直接上传凭证文件，推荐将服务账号JSON内容作为环境变量传入：

1. 在平台的环境变量设置中添加GOOGLE_SERVICE_ACCOUNT_JSON，值为服务账号JSON的完整字符串（注意不要有换行）。
2. 修改代码直接加载JSON内容，无需依赖文件路径：

import { NextApiRequest, NextApiResponse } from 'next';
import { GoogleAuth } from 'google-auth-library';

export default async function handler(
  req: NextApiRequest, 
  res: NextApiResponse
){
  let data: any;
  // 直接从环境变量加载服务账号JSON
  const auth = new GoogleAuth({
    credentials: JSON.parse(process.env.GOOGLE_SERVICE_ACCOUNT_JSON!)
  });
  const targetAudience = 'cloud_function_url';
  const url = targetAudience;

  try {
    console.info(`request ${url} with target audience ${targetAudience}`);
    const client = await auth.getIdTokenClient(targetAudience);
    const response = await client.request({ url });
    console.info(response.data);
    data = response.data;
    res.status(200).json({ data });
  } catch (error) {
    console.error((error as Error).message);
    res.status(500).json({ error: (error as Error).message });
  }
}

关键注意事项 #

• 不要将credentials.json提交到代码仓库，确保它在.gitignore中。
• 异步流程必须用await等待完成后再返回响应，否则会出现数据未就绪的问题。
• 生产环境使用JSON字符串作为环境变量时，要确保字符串格式正确，没有多余的空格或换行。

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