使用PyInstaller打包Django项目为exe时遇索引错误求助

问题原因 #

1. 单文件打包模式下，PyInstaller会将所有资源解压到临时目录，你代码里指定的manage.py并不存在于这个临时路径中，导致Django无法找到启动入口。
2. Django开发服务器默认开启的自动重载功能会尝试重启进程，但打包后的exe命令行参数结构与原Python脚本不同，Django的get_child_arguments函数解析参数时出现索引越界。

解决方案 #

方案1：关闭自动重载并修正启动参数 #

修改你的start.py，添加--noreload参数关闭自动重载，同时将启动入口改为当前脚本名（打包后exe会识别为自身）：

import os
import time
import webbrowser
from django.core.management import execute_from_command_line

os.environ.setdefault("DJANGO_SETTINGS_MODULE", "django_test.settings")

def run_server():
    # 替换manage.py为当前脚本名，添加--noreload关闭自动重载
    execute_from_command_line(["start.py", "runserver", "--noreload"])

if __name__ == "__main__":
    run_server()
    # 可选：延迟2秒后自动打开浏览器
    # time.sleep(2)
    # webbrowser.open("http://127.0.0.1:8000")

重新执行打包命令：

pyinstaller start.py --onefile

方案2：直接调用RunServer命令核心逻辑 #

绕开execute_from_command_line，直接实例化RunServer命令并启动，更灵活可控：

import os
import time
import threading
import webbrowser
from django.core.management.commands.runserver import Command as RunServerCommand

os.environ.setdefault("DJANGO_SETTINGS_MODULE", "django_test.settings")
import django
django.setup()

def run_server():
    server = RunServerCommand()
    # 启动服务器，指定地址并关闭自动重载
    server.handle(addrport="127.0.0.1:8000", noreload=True)

if __name__ == "__main__":
    # 用线程启动服务器，避免阻塞浏览器打开逻辑
    threading.Thread(target=run_server).start()
    time.sleep(2)
    webbrowser.open("http://127.0.0.1:8000")

重新打包后运行exe即可正常启动服务器并打开浏览器。

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