Strapi管理面板偶发白屏问题求助（附报错与依赖配置）

问题概述 #

搭建的Strapi管理面板在开发和生产环境中，加载任意页面时偶尔出现白屏，多次刷新后可恢复正常。控制台报错包含以下类型：

• TypeError: Cannot convert undefined or null to object
• TypeError: Qe is not a function or its return value is not iterable
• TypeError: Property description must be an object: sc-kgwpUT mOrCs

环境配置（package.json） #

{
  "name": "pro-s",
  "private": true,
  "version": "0.1.1",
  "description": "A Strapi application",
  "scripts": {
    "develop": "strapi develop",
    "start": "strapi start",
    "build": "strapi build",
    "strapi": "strapi"
  },
  "dependencies": {
    "@_sh/strapi-plugin-ckeditor": "^1.0.7",
    "@strapi/icons": "^1.7.3",
    "@strapi/plugin-graphql": "^4.1.8",
    "@strapi/plugin-i18n": "4.4.3",
    "@strapi/plugin-users-permissions": "4.4.3",
    "@strapi/provider-email-sendgrid": "^4.1.12",
    "@strapi/provider-upload-aws-s3": "^4.1.9",
    "@strapi/strapi": "4.4.3",
    "chargebee": "^2.10.0",
    "cheerio": "^1.0.0-rc.11",
    "koa-static": "^5.0.0",
    "mime-types": "^2.1.35",
    "moment": "^2.29.3",
    "pg": "^8.6.0",
    "pg-connection-string": "^2.5.0",
    "react": "^18.2.0",
    "react-dom": "^18.2.0",
    "sanitize-filename": "^1.6.3",
    "strapi-plugin-measurement-protocol": "^1.0.1",
    "strapi-provider-email-smtp": "^1.0.3"
  },
  "author": {
    "name": "A Strapi developer"
  },
  "strapi": {
    "uuid": "9b33cdcc-bad0-4fee-a674-da565a2a2b4c"
  },
  "engines": {
    "node": ">=14.19.1 <=18.x.x",
    "npm": "8.11.0"
  },
  "license": "MIT"
}

报错详情 #

main.71cca37f.js:50 TypeError: Cannot convert undefined or null to object
    at propertyIsEnumerable (<anonymous>)
    at j1 (7098.8b467fed.chunk.js:1:441)
    at R (7098.8b467fed.chunk.js:341:24043)
    at ss (main.71cca37f.js:48:54759)
    at vc (main.71cca37f.js:48:64597)
    at h4 (main.71cca37f.js:52:10075)
    at bd (main.71cca37f.js:52:989)
    at l4 (main.71cca37f.js:52:917)
    at h0 (main.71cca37f.js:52:768)
    at U0 (main.71cca37f.js:50:11072)
// 其他重复报错内容省略

排查与解决方案 #

1. 清理构建缓存并重新构建 #

缓存文件损坏可能导致偶发的资源加载异常，执行以下步骤：

• 删除项目根目录下的 .cache 和 build 文件夹
• 重新安装依赖：npm install
• 重新构建项目：npm run build（生产环境）或重启开发服务：npm run develop

2. 修复插件版本不兼容问题 #

从package.json可见，@strapi/plugin-graphql版本为4.1.8，与Strapi核心版本4.4.3差异过大，可能引发冲突。将所有Strapi官方插件更新至与核心版本一致：

• 修改package.json中@strapi/plugin-graphql的版本为4.4.3
• 执行npm install更新依赖

3. 排查第三方插件冲突 #

第三方插件可能存在兼容性问题，逐一禁用排查：

• 暂时移除@_sh/strapi-plugin-ckeditor和strapi-plugin-measurement-protocol等非官方插件
• 重启服务观察是否还会出现白屏
• 若问题消失，逐个重新安装插件并验证，找到冲突插件后更换替代方案或等待插件更新

4. 调整React版本兼容性 #

Strapi 4.4.3默认依赖React 17.x，当前项目使用React 18.2.0，版本不匹配可能导致React渲染异常：

• 将react和react-dom版本降级至^17.0.2
• 执行npm install更新依赖后重新构建

5. 检查生产环境静态资源配置 #

若仅生产环境出现问题，需确认：

• 静态资源服务器正确配置，所有chunk文件可正常访问
• CDN缓存策略是否合理，避免缓存过期的旧资源
• 确保生产环境的Node.js版本符合engines字段要求（>=14.19.1 <=18.x.x）

内容的提问来源于stack exchange，提问作者Bilal Rabbi