# 当填充时，空的 morphMany 关系会返回 [] 而不是 null

> Source: https://strapi.nodejs.cn/cms/migration/v4-to-v5/breaking-changes/morph-many-serialization

🌐 Empty morphMany relations return [] instead of null when populated

在 Strapi 5 中，填充一个空的 `morphMany` 关系（包括像图库这样的 `type: 'media', multiple: true` 字段）会返回 `[]` 而不是 `null`。更新检查 `field === null` 的客户端代码，把 `[]` 当作空状态处理。

🌐 In Strapi 5, populating an empty `morphMany` relation (including `type: 'media', multiple: true` fields such as a gallery) returns `[]` instead of `null`. Update client code that checks `field === null` to treat `[]` as the empty state.

在 Strapi 5 中，空的 `morphMany` 关系和 `type: 'media', multiple: true` 字段（比如图库）在被填充时现在会序列化为空数组，这与 `oneToMany` 和 `manyToMany` 关系保持一致。之前，当没有相关条目时，这些字段会返回 `null`。

🌐 In Strapi 5, empty `morphMany` relations and `type: 'media', multiple: true` fields (such as a gallery) now serialize as an empty array when populated, consistent with `oneToMany` and `manyToMany` relations. Previously, these fields returned `null` when no related entries existed.

此页面是[重大更改数据库](/cms/migration/v4-to-v5/breaking-changes)的一部分，提供关于重大更改的信息以及从 Strapi v4 迁移到 Strapi 5 的附加说明。

🌐 This page is part of the [breaking changes database](/cms/migration/v4-to-v5/breaking-changes) and provides information about the breaking change and additional instructions to migrate from Strapi v4 to Strapi 5.

- Is this breaking change affecting plugins? Yes
- Is this breaking change automatically handled by a codemod? No

## 重大变更描述 {#breaking-change-description}

🌐 Breaking change description

**在 Strapi v4 中**

向空的 `morphMany` 关系或多媒体字段填充内容会返回 `null`：

🌐 Populating an empty `morphMany` relation or a multiple media field returned `null`:

```json
{
  "gallery": null
}
```

**在 Strapi 5 中**

填充一个空的 `morphMany` 关系或一个多媒体字段会返回一个空数组：

🌐 Populating an empty `morphMany` relation or a multiple media field returns an empty array:

```json
{
  "gallery": []
}
```

## 迁移 {#migration}

🌐 Migration

本节重新组合了有关引入的重大更改的有用说明和程序。

🌐 This section regroups useful notes and procedures about the introduced breaking change.

### 注意 {#notes}

🌐 Notes

- 此更改适用于所有 `morphMany` 关系类型，包括 `type: 'media', multiple: true` 字段（例如图库字段）。
- 这个改变是无条件的，不受 `api.documents.strictRelations` 设置控制。
- 查看 [文档服务 API：填充字段](/cms/api/document-service/populate) 和 [REST API：填充与字段选择](/cms/api/rest/populate-select#population) 以获取关于填充关系的相关信息。

### 手动操作 {#manual-procedure}

🌐 Manual procedure

检查客户端代码、Webhook 和使用已填充的 `morphMany` 或多个媒体字段的集成。

🌐 Check client code, webhooks, and integrations that consume populated `morphMany` or multiple media fields.

1. 在你的代码库中搜索那些基于 `field === null` 分支的代码，或把 `null` 当作已填充 `morphMany` 或多个媒体字段的“无值”处理的代码。
2. 用数组检查替换 `null` 检查，例如使用 `!field?.length`。

**之前**

```js
if (entry.gallery === null) {
  // handle empty gallery
}
```

**之后**

```js
if (!entry.gallery?.length) {
  // handle empty gallery
}
```