Heroku部署Django用django-excel上传xlsx报UnknownParameters错误如何解决

核心问题排查 #

你之前的调整方向完全不匹配Heroku的部署场景：pyinstaller及其隐藏导入配置是用于打包本地可执行桌面程序的功能，Heroku的Python运行环境直接运行Django源码，不需要打包，requirements.txt里的pyinstaller属于无效依赖，你参考的同类问题场景和你当前的部署场景完全不符。

具体修复步骤 #

• 第一步：清理无效依赖，删除requirements.txt中的pyinstaller条目
• 第二步：手动注册pyexcel插件，解决Heroku环境下插件自动发现失效的问题，在Django项目的settings.py文件末尾添加如下代码：

# 显式导入pyexcel相关插件触发自动注册
import pyexcel_xls
import pyexcel_xlsx
import pyexcel_ods

• 第三步：修正视图函数的参数传递：报错提示的三个参数均为None，如果你不需要使用model、initializer参数，不要在调用django-excel相关方法时显式传入值为None的对应参数，删除这些多余的参数传递即可，django-excel的参数校验会拒绝接收未定义的null值参数
• 第四步（可选）：如果上述操作后仍有报错，在项目根目录新建.profile文件，添加如下环境变量配置，强制pyexcel在应用启动时重新扫描插件：

export PYEXCEL_PLUGIN_AUTOLOAD=yes

关于Heroku配置的补充说明 #

Heroku标准Python部署流程不涉及pyinstaller打包，不存在所谓的hidden-import配置需求。如果你需要打包Django为单文件可执行程序做离线部署才需要用到pyinstaller的隐藏导入配置，正常Web部署不需要相关操作。

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