Flask项目部署后静态文件返回404问题求助

针对本地运行正常、部署后静态文件返回404的情况，按以下步骤排查：

• 检查静态文件权限
  部署服务器（尤其是Linux环境）下，Web服务进程（如www-data、nginx用户）需要有读取static目录及文件的权限。执行以下命令修正权限：

  chmod -R 755 /path/to/your/project/static
  chmod -R 644 /path/to/your/project/static/*
  

• 确认应用启动路径与方式
  使用WSGI服务器（如Gunicorn、uWSGI）启动时，必须在项目根目录执行启动命令，确保Flask能找到static文件夹。例如Gunicorn启动命令：

  cd /path/to/your/project && gunicorn app:app
  

• 显式配置static_url_path
  在初始化Flask应用时，添加static_url_path='/static'参数，强制静态文件的URL路由前缀，避免部署环境的路径解析问题：

  app = Flask(__name__, template_folder='templates', static_folder='static', static_url_path='/static')
  

• 检查反向代理/Web服务器配置
  如果用Nginx或Apache做反向代理，需要配置直接处理静态文件请求，避免转发给Flask。以Nginx为例，添加如下location块：

  location /static {
      alias /path/to/your/project/static;
      expires 30d;
      add_header Cache-Control "public, max-age=2592000";
  }
  

• 排查大小写敏感问题
  Linux系统文件名大小写敏感，本地Windows环境不敏感。检查代码中引用的静态文件路径（比如css/roulette_style.css）是否与服务器上的实际文件完全一致，包括大小写。

• 确认文件同步完整性
  检查.gitignore或部署工具的配置，确保static目录及所有子文件被正确同步到服务器，没有被忽略。

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