使用PyInstaller打包Django项目后静态文件丢失问题求助

问题背景 #

使用PyInstaller打包Django项目后，运行可执行文件时所有静态文件（包括admin的css/js）都返回404错误，但本地debug模式下运行正常。已执行collectstatic、配置.spec文件的datas、设置STATIC_ROOT和STATIC_URL。

解决步骤 #

1. 修正打包后的BASE_DIR与STATIC_ROOT路径

PyInstaller打包后，项目文件会被解压到临时目录，原有的BASE_DIR指向开发时的本地路径，运行时无法找到静态文件。需要通过sys._MEIPASS获取打包后的资源根目录：

修改settings.py：

import os
import sys

# 区分开发环境与打包环境的BASE_DIR
if getattr(sys, 'frozen', False):
    # 打包后的运行环境
    BASE_DIR = sys._MEIPASS
else:
    # 本地开发环境
    BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, 'static')

2. 确保.spec文件的datas包含所有静态资源

检查collectstatic是否将admin的静态文件（如static/admin/目录）正确生成，同时确认.spec的datas配置覆盖了这些文件：

datas=[
    ('remotescope/templates/remotescope/', 'remotescope/templates/remotescope'),
    ('static/', 'static'),
    # 若admin静态文件未被自动包含，可单独添加（替换python3.x为实际版本）
    ('venv/lib/python3.x/site-packages/django/contrib/admin/static/admin/', 'static/admin'),
    ('remotescope/logging.conf', '.'),
],

修改后重新执行pyinstaller your_project.spec重新打包。

3. 强制Django在非debug模式下提供静态文件服务

默认情况下，django.conf.urls.static.static()仅在DEBUG=True时生效，打包后DEBUG通常为False，因此需要改用django.contrib.staticfiles.views.serve强制提供静态文件服务：

修改项目根目录的urls.py：

from django.contrib import admin
from django.urls import path, include, re_path
from django.contrib.staticfiles.views import serve

def static_serve(request, path, **kwargs):
    return serve(request, path, insecure=True, **kwargs)

urlpatterns = [
    path('admin/', admin.site.urls),
    path('remotescope/', include('remotescope.urls')),
]

# 添加静态文件路由，不受DEBUG状态限制
urlpatterns += [
    re_path(r'^static/(?P<path>.*)$', static_serve),
]

insecure=True参数允许在DEBUG=False时提供静态文件服务，适合打包后的单文件运行场景。

4. 检查settings.py的关键配置

确保打包运行时的配置正确：

DEBUG = False
ALLOWED_HOSTS = ['0.0.0.0', 'localhost']  # 允许访问的主机/IP

验证 #

重新打包后运行./RemoteScope runserver 0.0.0.0:8000 --noreload，检查静态文件是否能正常加载。

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