Contentful v10+Node.js18中getEntry无法获取嵌套字段值问题

问题根源 #

你用EntryLink<Example>定义了point字段的类型，但Contentful的getEntry方法默认不会自动解析嵌套的引用条目，返回的point只是包含元数据的链接对象，并非完整的Example条目，因此无法直接访问rate字段。

解决步骤 #

1. 调用getEntry时添加include参数

通过include指定要解析的嵌套层级，一级嵌套设为1，多层嵌套按需提高数值（最大支持10层）。

2. 调整类型定义

解析后的链接字段会变成完整的Entry<Example>类型，而非EntryLink<Example>，需要同步修改接口定义。

修改后的完整代码 #

import { createClient, type Entry, type EntryFieldTypes } from 'contentful';

interface Example {
  contentTypeId: 'item';
  fields: {
    title: EntryFieldTypes.Text;
    rate: EntryFieldTypes.Number;
  };
}

interface Global {
  contentTypeId: 'product';
  fields: {
    title: EntryFieldTypes.Text;
    // 解析后为完整的Entry类型，替换原EntryLink
    point: Entry<Example>;
  };
}

const client = createClient({
  space: '你的Space ID',
  accessToken: '你的Access Token',
});

// 传入include参数解析嵌套引用
const data = await client.getEntry<Global>('product', {
  include: 1,
});

// 现在可正常访问嵌套字段
console.log(data.fields.point.fields.rate);

补充说明 #

• 如果存在多层嵌套引用（比如Example里还有其他链接字段），需对应提高include的数值，并将深层链接字段的类型也改为Entry<对应接口>。
• include参数的取值范围是0-10，0表示不解析任何引用（默认值）。

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