通过Nginx反向代理访问Strapi管理面板时出现TypeError报错求助

这个报错通常是Strapi前端无法正确获取应用环境配置导致的，结合你直接IP+端口访问正常的情况，大概率是反向代理配置或Strapi自身配置的问题，以下是常见原因及解决办法：

• Nginx反向代理缺失关键头信息
  Strapi管理面板依赖X-Forwarded-Proto等头信息判断当前请求的协议（HTTP/HTTPS），如果Nginx没配置这些，前端会因无法识别正确环境而触发错误。
  修改Nginx配置文件（通常在/etc/nginx/sites-available/下），添加必要的代理头：

location / {
    proxy_pass http://localhost:1337;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme; # 核心配置，必须添加
}

保存后重启Nginx：sudo systemctl restart nginx

• Strapi未配置正确的外部访问地址
  Strapi需要明确知道反向代理后的公开URL，否则前端资源加载和API请求会出现异常。
  修改项目根目录的config/server.js：

module.exports = ({ env }) => ({
  host: env('HOST', '0.0.0.0'),
  port: env.int('PORT', 1337),
  app: {
    keys: env.array('APP_KEYS'),
  },
  url: env('PUBLIC_URL', 'https://你的实际域名'), // 替换为你的域名
  proxy: true, // 启用代理模式
});

修改后重启Strapi服务。

• 浏览器缓存引发资源冲突
  之前直接访问IP端口的旧资源可能留在缓存中，和域名访问的新资源混合加载导致错误。
  解决方式：

  1. 打开浏览器开发者工具（F12），在「网络」面板勾选「禁用缓存」，刷新页面测试
  2. 手动清除浏览器缓存（快捷键Ctrl+Shift+Delete）

• Strapi版本与代理配置不兼容
  部分Strapi v4.x版本对反向代理的头信息要求更严格，若配置不符合版本要求会触发此类错误。
  解决方式：

  1. 查看对应Strapi版本的官方反向代理配置文档
  2. 尝试升级Strapi到最新稳定版，或调整Nginx配置适配当前版本

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