Strapi v4中entityService无法找到/创建单类型实体问题求助

我在Strapi v4中尝试实现一个功能：当任意其他内容类型发生更新（创建、修改、删除）时，自动更新单类型version中的contentVersion字段。

我在其他内容类型的lifecycles.js中调用incrementVersion函数：

module.exports = {
  async afterCreate() {
    await strapi.service('api::version.version').incrementVersion();
  },
  async afterUpdate() {
    await strapi.service('api::version.version').incrementVersion();
  },
  async afterDelete() {
    await strapi.service('api::version.version').incrementVersion();
  },
};

src/api/version/services/version.js中的代码如下：

'use strict';

/**
 * version service
 */

const { createCoreService } = require('@strapi/strapi').factories;

module.exports = createCoreService('api::version.version', ({ strapi }) => ({
    async incrementVersion() {
        const versions = await strapi.entityService.findMany('api::version.version');
        
        if (versions && versions.length > 0) {
          const version = versions[0];
          let currentVersion = version.contentVersion || 0; 
          currentVersion += 1; 
      
          await strapi.entityService.update('api::version.version', version.id, {
            data: {
                attributes: {
                  contentVersion: currentVersion,
                }
              },
          });
      
        } else {
          console.log('Global config not found, creating new entry');
          await strapi.entityService.create('api::version.version', {
            data: {
              attributes: {
                contentVersion: 1,
              }
            },
          });
        }
      }
}));

从日志可以看到incrementVersion函数已被成功调用，但始终找不到Version实体，且else分支也无法创建实体，服务器日志反复输出：

Global config not found, creating new entry

原因及解决方法 #

1. 单类型的查询方式错误 #

Strapi v4中，单类型（Single Type）只能有一个实例，不能用findMany查询——这个方法是针对集合类型设计的，对单类型调用会返回空数组，这就是你始终进入else分支的原因。

正确的查询方式是使用findOne：

const version = await strapi.entityService.findOne('api::version.version');

2. 实体操作的参数格式错误 #

不管是创建还是更新单类型，都不需要在data里嵌套attributes字段，Strapi v4的实体服务接受直接传递字段键值对，嵌套attributes会导致操作失败。

• 正确的创建代码：

  await strapi.entityService.create('api::version.version', {
    data: {
      contentVersion: 1,
    },
  });
  

• 正确的更新代码：

  await strapi.entityService.update('api::version.version', version.id, {
    data: {
      contentVersion: currentVersion,
    },
  });
  

修复后的完整service代码 #

'use strict';

const { createCoreService } = require('@strapi/strapi').factories;

module.exports = createCoreService('api::version.version', ({ strapi }) => ({
    async incrementVersion() {
        // 用findOne查询单类型实例
        const version = await strapi.entityService.findOne('api::version.version');
        
        if (version) {
          let currentVersion = version.contentVersion || 0; 
          currentVersion += 1; 
      
          await strapi.entityService.update('api::version.version', version.id, {
            data: {
              contentVersion: currentVersion,
            },
          });
      
        } else {
          console.log('Global config not found, creating new entry');
          await strapi.entityService.create('api::version.version', {
            data: {
              contentVersion: 1,
            },
          });
        }
      }
}));

额外注意事项 #

• 确保已在Strapi后台正确创建version单类型，并添加了contentVersion数字类型字段；
• 本地开发时，修改代码后需要重启Strapi服务才能生效。

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