Strapi v3(MongoDB)迁移至v4(Postgres)启动报错求助

DevOps 小满

2026-7-27

解决Strapi v3转v4迁移启动报错Cannot read properties of undefined (reading 'register')

问题原因

该错误核心是依赖版本不兼容，你安装的是Strapi v3版本的数据库连接器，和Strapi v4的架构不匹配，同时可能残留了MongoDB相关的旧依赖/配置，导致模块加载冲突。

解决方案

1. 清理旧依赖与缓存

删除项目根目录下的node_modules文件夹
删除package-lock.json（或yarn.lock）文件
执行缓存清理命令：
```
npm cache clean --force
```

2. 替换为v4兼容的依赖

卸载Strapi v3版本的旧连接器：

npm uninstall strapi-connector-bookshelf@3.6.9 knex@0.21.19

安装Strapi v4适配的Postgres相关依赖：

npm install @strapi/provider-database-postgres knex

注：Strapi v4使用@strapi/provider-database-postgres替代了v3的strapi-connector-bookshelf，无需指定固定版本，npm会自动匹配当前Strapi v4的兼容版本。

3. 修正数据库配置

确保config/database.js（或config/database.ts）采用Strapi v4的配置格式，示例如下：

module.exports = ({ env }) => ({
  connection: {
    client: 'postgres',
    connection: {
      host: env('DATABASE_HOST', 'localhost'),
      port: env.int('DATABASE_PORT', 5432),
      database: env('DATABASE_NAME', 'strapi'),
      user: env('DATABASE_USERNAME', 'strapi'),
      password: env('DATABASE_PASSWORD', 'strapi'),
      ssl: env.bool('DATABASE_SSL', false),
    },
  },
});

同时彻底移除所有MongoDB相关的依赖（比如strapi-connector-mongoose）和配置文件。