注册后Strapi Admin面板持续加载无法进入仪表盘求助

核心排查方向与解决方案 #

1. 补全生产环境.env关键配置变量 #

本地环境的.env由Strapi自动生成，生产环境需手动配置所有核心密钥与数据库参数，缺失会导致Admin面板验证异常：

• PostgreSQL数据库相关配置：

  DATABASE_CLIENT=postgres
  DATABASE_HOST=你的数据库IP/域名
  DATABASE_PORT=5432
  DATABASE_NAME=strapi_prod
  DATABASE_USERNAME=prod_db_user
  DATABASE_PASSWORD=你的数据库密码
  DATABASE_SSL=false # 若服务器开启SSL则设为true，按需调整
  

• Strapi核心密钥（可通过openssl rand -hex 16或openssl rand -hex 32生成随机字符串）：

  APP_KEYS=key1,key2,key3 # 至少3个值，用逗号分隔
  ADMIN_JWT_SECRET=随机32位字符串
  API_TOKEN_SALT=随机32位字符串
  JWT_SECRET=随机32位字符串
  STRAPI_URL=https://你的生产域名.com # 必须配置，用于Admin面板资源定位
  

2. 确保Admin面板已正确构建并部署 #

生产环境部署前必须执行构建命令，否则Admin面板静态资源缺失：

npm run build # 或 yarn build

同时检查服务器上build目录的权限，确保Strapi进程有读写权限；反向代理（Nginx/Apache）需正确转发/admin路径的请求到Strapi端口，且允许访问静态资源。

3. 验证PostgreSQL数据库权限与连接 #

• 确认生产数据库用户对Strapi所有表拥有SELECT、INSERT、UPDATE、DELETE权限
• 检查服务器防火墙是否允许Strapi服务器访问PostgreSQL默认端口（5432）
• 可通过以下命令测试数据库连接稳定性：

  psql -h 数据库地址 -U 用户名 -d 数据库名
  

4. 调整server.js与admin.js生产配置 #

确保配置文件与.env变量对应，适配生产环境：

server.js示例：

module.exports = ({ env }) => ({
  host: env('HOST', '0.0.0.0'),
  port: env.int('PORT', 1337),
  url: env('STRAPI_URL'), // 绑定生产域名
  app: {
    keys: env.array('APP_KEYS'),
  },
});

admin.js示例：

module.exports = ({ env }) => ({
  auth: {
    secret: env('ADMIN_JWT_SECRET'), // 对应.env中的密钥
  },
  apiToken: {
    salt: env('API_TOKEN_SALT'),
  },
  transfer: {
    token: {
      salt: env('TRANSFER_TOKEN_SALT'), // 可通过openssl生成后添加到.env
    },
  },
});

5. 清除浏览器缓存与Cookie #

本地环境遗留的缓存Cookie可能干扰生产环境验证，清空浏览器缓存和Cookie后重新尝试登录。

内容的提问来源于stack exchange，提问作者Willem Beké