Vite与Django集成报错：TypeError参数类型不匹配问题

错误核心原因 #

这个错误本质是django_vite.core.asset_loader.DjangoViteConfig()初始化时，传入的参数被识别为布尔值而非预期的字典类型，通常由两种情况引发：

• django-vite版本与Django 5.1.5不兼容，旧版本的配置加载逻辑无法适配Django 5.x的环境
• DJANGO_VITE配置字典在settings.py中被后续代码意外覆盖为布尔值（比如误写DJANGO_VITE = DEBUG）

具体解决方案 #

1. 安装适配Django 5.x的django-vite版本 #

优先安装最新稳定版的django-vite，确保其支持Django 5.x：

pip install --upgrade django-vite

若最新版仍有问题，可指定明确兼容的版本（1.5.0及以上版本已适配Django 5.x）：

pip install django-vite>=1.5.0

2. 确认DJANGO_VITE配置未被篡改 #

检查settings.py文件，确保DJANGO_VITE字典定义后没有被后续代码修改。可在配置后添加验证代码：

DJANGO_VITE = {
    "dev_mode": DEBUG,
    "manifest_path": os.path.join(BASE_DIR, "static", "manifest.json"),
    "static_url_prefix": STATIC_URL,
}
# 验证配置类型与内容
print(f"DJANGO_VITE类型: {type(DJANGO_VITE)}, 内容: {DJANGO_VITE}")

启动服务器时，若输出显示类型为dict则配置正常；若为bool，需定位并修复覆盖配置的代码。

3. 清理Django配置缓存 #

运行命令清除配置缓存，避免旧配置残留：

python manage.py clearcache

完成后重新启动开发服务器。

4. 校验Vite与Django配置一致性 #

确保vite.config.ts中的路径配置与Django完全匹配：

• base: "/static/" 需和Django的STATIC_URL保持一致
• build.outDir: "../backend/static/" 需准确指向Django项目的static目录（根据自身项目结构调整路径）

内容的提问来源于stack exchange，提问作者Lino De Marco