Nginx部署Flask应用后Flask Admin页面静态文件404问题求助

• 第一步：排查反向代理配置
  部署到Ubuntu通常会搭配Nginx/Apache作为反向代理，大部分该问题都是因为反向代理规则错误导致/admin/static开头的请求没有转发给Flask应用，而是被Web服务器指向了本地文件系统的静态目录。你可以检查Nginx配置，确保所有/admin开头的请求都被正确proxy_pass到你的Gunicorn/uWSGI监听地址，不要为/admin/static单独配置alias规则。
• 第二步：排查大小写敏感问题
  Windows、macOS默认文件系统大小写不敏感，而Ubuntu默认大小写敏感，这是该类问题最常见的诱因。你配置的FLASK_ADMIN_SWATCH = 'Slate'首字母大写，但Flask Admin内置的swatch文件名实际为全小写的slate，本地环境不区分大小写可以正常访问，服务器就会返回404。直接修改配置为：

  app.config['FLASK_ADMIN_SWATCH'] = 'slate'
  

  重启应用后测试即可。
• 第三步：验证依赖一致性
  检查服务器虚拟环境中安装的Flask Admin版本是否和本地一致，以及静态文件是否完整：
  1. 分别在本地和服务器执行pip show flask-admin确认版本号相同
  2. 若版本不同，可统一安装指定版本，例如pip install flask-admin==[你本地的版本号]
  3. 可以直接在服务器本地请求Flask应用的监听端口验证静态文件是否存在：

  curl http://127.0.0.1:[你的Flask应用端口]/admin/static/bootstrap/bootstrap3/swatch/slate/bootstrap.min.css
  

  如果该请求能返回文件内容，说明问题出在反向代理层；如果同样返回404，说明应用本身的配置或依赖有问题。
• 第四步：排查自定义路由冲突
  检查是否存在自定义的/admin前缀路由、自定义static_folder配置，或是APPLICATION_ROOT配置错误，覆盖了Flask Admin默认的静态文件路由规则。

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