一、问题/场景描述
在使用宝塔面板部署Python项目（如Django或Flask应用）时，一个常见的问题是网站的静态文件（如CSS、JavaScript、图片）无法加载，浏览器开发者工具显示404 Not Found错误。这通常发生在项目成功运行，但样式和脚本却丢失的情况下，严重影响网站的正常显示和功能。
二、原因分析
该问题的主要原因在于Web服务器（通常是Nginx）未能正确地将静态文件的请求映射到项目实际的静态文件目录。在开发环境下，Django或Flask的开发服务器会自动处理静态文件，但在生产环境使用Nginx+uWSGI或Gunicorn部署时，需要明确配置静态文件的路径。宝塔面板虽然简化了部署流程，但在创建Python项目时，其自动生成的Nginx配置可能未包含或未正确指向您项目收集静态文件（collectstatic）后的目录，导致所有对/static/路径的请求都无法找到对应的物理文件。
三、详细解决步骤
解决此问题的核心是检查和修改Nginx的站点配置文件，确保其正确代理静态文件请求。请按照以下步骤操作。
步骤1：定位项目静态文件目录
首先，确认您的Django项目静态文件存放的绝对路径。通常，在运行python manage.py collectstatic命令后，静态文件会集中到STATIC_ROOT配置项指定的目录中。您可以在项目的settings.py文件中找到它。
# 在Django的settings.py中查看
STATIC_ROOT = ‘/www/wwwroot/your_project/static/‘
请记录下这个路径，例如/www/wwwroot/my_django_site/static。
步骤2：修改宝塔面板中的Nginx配置
登录宝塔面板，进入“网站”页面，找到您的Python项目对应的站点，点击“设置”。在弹出窗口中，选择“配置文件”标签页。在配置文件的server块内，找到类似location / { ... }的配置，并在其}之前或之后，添加一个专门处理静态文件的location块。
server {
# ... 其他现有配置 ...
location / {
include uwsgi_params;
uwsgi_pass 127.0.0.1:5000; # 端口号根据您的uWSGI或Gunicorn设置调整
# ... 其他代理参数 ...
}
# 添加以下静态文件配置块
location /static/ {
alias /www/wwwroot/my_django_site/static/; # 此处替换为您的实际STATIC_ROOT路径
expires 30d;
access_log off;
}
# 如果还有用户上传的媒体文件，也可以类似地添加
# location /media/ {
# alias /www/wwwroot/my_django_site/media/;
# expires 30d;
# }
}
步骤3：保存并重载Nginx配置
在宝塔面板的配置文件编辑框中，点击“保存”。然后，您需要重载Nginx服务使配置生效。可以回到宝塔面板首页，在“软件商店”中找到Nginx，点击右侧的“重载配置”，或者直接在终端执行命令。
sudo /etc/init.d/nginx reload
# 或使用 systemctl
sudo systemctl reload nginx
步骤4：检查权限与路径
如果配置正确后问题依旧，请检查静态文件目录的权限以及路径中是否包含中文或特殊字符。确保Nginx进程用户（通常是www用户）有读取该目录的权限。
# 检查目录是否存在
ls -la /www/wwwroot/my_django_site/static/
# 修改目录权限（谨慎操作，755通常是安全的）
chmod -R 755 /www/wwwroot/my_django_site/static/
# 修改目录所有者（将username替换为您的实际用户，如www）
chown -R username:username /www/wwwroot/my_django_site/static/
完成以上步骤后，清除浏览器缓存并刷新页面，静态文件应该可以正常加载了。
四、注意事项
修改Nginx配置文件前务必做好备份。alias指令后的路径必须以斜杠/结尾，且必须与location后的/static/匹配。对于Flask等框架，静态文件路径可能不同，请根据项目实际情况调整。如果使用了CDN或对象存储，则无需此Nginx配置，但需确保项目中的静态文件URL设置正确。
五、适用环境
此解决方案适用于通过宝塔面板部署，并使用Nginx作为反向代理的Django、Flask等Python Web项目。