Next.js v13 generateMetadata()服务器部署数据获取异常求助

本地环境中generateMetadata函数能正常调用WooCommerce接口获取数据并渲染元信息，但部署到服务器后出现客户端异常。使用静态数据时无问题，推测是数据获取环节出错。

相关代码 #

export async function generateMetadata({ params }) {

  const collection = await WooCommerce.get(`products/categories/${params.id}`)
    .then((response) => response.data)
    .catch((error) => {
      console.log(error);
    });

    return {
      title: `${collection.name} | Flores El Gato`,
    };
}

错误日志 #

TypeError: Cannot read properties of undefined (reading 'name')
at Module.generateMetadata (/var/task/.next/server/app/collection/[id]/page.js:1221:20)
at process.processTicksAndRejections (node:internal/process/task_queues:95:5)
[Error: An error occurred in the Server Components render. The specific message is omitted in production builds to avoid leaking sensitive details. A digest property is included on this error instance which may provide additional details about the nature of the error.] {
digest: '132657019'
}

问题根源 #

错误提示Cannot read properties of undefined (reading 'name')，说明collection是undefined——也就是WooCommerce接口请求在服务器端失败了，但代码里的catch只打印错误却没做处理，导致后续尝试读取undefined的name属性直接报错。

本地正常但服务器失败，大概率是以下原因：

• 服务器环境没配置WooCommerce的API密钥（比如WOOCOMMERCE_CONSUMER_KEY、WOOCOMMERCE_CONSUMER_SECRET这类环境变量）
• 服务器IP被WooCommerce后台的IP白名单拦截
• WooCommerce API的基础URL在服务器环境配置错误（比如本地用localhost，服务器要用正式域名）
• 服务器网络无法访问WooCommerce站点（比如防火墙限制）

修复步骤 #

1. 完善错误处理：先避免接口失败导致页面崩溃，给collection设置默认值，同时在catch里记录详细错误：

export async function generateMetadata({ params }) {
  let collection = { name: '默认分类' }; // 设置兜底默认值
  try {
    const response = await WooCommerce.get(`products/categories/${params.id}`);
    collection = response.data;
  } catch (error) {
    // 打印完整错误信息，方便排查
    console.error('WooCommerce API请求失败:', error.response?.data || error.message);
  }

  return {
    title: `${collection.name} | Flores El Gato`,
  };
}

2. 检查服务器环境变量：确认服务器上已正确配置WooCommerce API所需的所有环境变量，包括密钥、API地址等，和本地环境保持一致（注意不要把密钥硬编码到代码里）。

3. 验证服务器网络与权限：

   • 测试服务器是否能ping通WooCommerce站点域名
   • 检查WooCommerce后台的API设置，确认服务器IP在允许访问的列表中（如果开启了IP白名单）
   • 确认API密钥的权限足够读取产品分类数据（需要勾选"读取"权限）

4. 查看详细错误日志：部署后查看服务器的完整日志，上面的console.error会输出具体错误原因，比如401未授权、404找不到资源、网络超时等，根据日志针对性解决。

内容的提问来源于stack exchange，提问作者Noe Alejandro Castro