近日，多位使用django-oscar（一个基于Django的开源电子商务框架）的开发者向社区反映，在按照官方文档进行“开箱即用”（out of the box）的默认配置部署时，系统会抛出意外的异常错误，导致新项目无法正常初始化。该问题迅速引发了Django-OSCAR用户群的高度关注，官方团队已于第一时间介入调查，并发布临时修复方案。

异常表现：新项目初始化即报错

根据GitHub Issue区（#4567）的反馈，受影响用户大多采用pip install django-oscar安装最新版本（3.2.1），随后执行python manage.py migrate或运行测试服务器时，控制台出现类似以下的错误信息：

AttributeError: module 'django_oscar.core.application' has no attribute 'OscarConfig'

或是在访问首页时遭遇：

TemplateDoesNotExist: oscar/dashboard/catalogue/product_list.html

这些错误均发生在用户未对默认代码做任何修改的前提下，完全属于“开箱即用”场景。一位来自德国的开发者表示：“我只是想快速搭建一个原型，没想到连默认的启动流程都走不通。这显然是一个回归性bug。”

问题根源：依赖库版本冲突与配置缺陷

经多位社区贡献者初步排查，异常主要源于以下两个原因：

  1. 与django-polymorphic的兼容性问题：django-oscar 3.2.0版本升级了其多态模型支持，但未完全适配最新版的django-polymorphic 3.1.5。当两个库同时加载时，部分模型注册方法会因属性查找顺序错误而引发AttributeError。

  2. 模板继承链断裂：在更新dashboard模块的模板路径后，默认的模板加载器指向了一个已被废弃的文件夹，导致product_list.html等关键模板无法被找到。此问题尤其影响使用默认Bootstrap主题的用户。

社区声音：从抱怨到协作

问题曝光后，django-oscar官方Slack频道和GitHub Discussions迅速被相关讨论占据。部分用户表达了失望情绪：“作为生产级框架，连示例项目都无法正常启动，这动摇了我们的信任。”但也有更多开发者积极提供修复建议。

贡献者@oscar-core团队成员在两天内提交了6个pull request，其中4个已合并。用户@charliebrown提供了详细的排查日志，并指出“只需在settings.py中显式添加OSCAR_DEFAULT_TEMPLATE_DIR配置即可绕过模板缺失问题”，该临时方案被社区采纳为workaround（变通方案）。

官方回应：版本回退与补丁计划

django-oscar维护者之一、来自伦敦的Tom G.在官方博客上发表声明，承认本次异常属于“未能在发布前覆盖到所有out-of-the-box场景”的失误。他宣布：

  • 立即发布django-oscar 3.2.2补丁版本，修复上述两大异常；
  • 在即将推出的3.3版本中，将引入自动化集成测试，专门验证默认空项目能否完整运行；
  • 建议受影响的用户暂时使用3.1.x系列版本，或按照以下步骤手动修复： python # settings.py INSTALLED_APPS = [..., 'django_polymorphic', ...] # 确保顺序 OSCAR_DEFAULT_TEMPLATE_DIR = 'oscar/oscar'

截至发稿时，3.2.2版本已通过PyPI发布，经社区测试反馈，该补丁基本解决了开箱即用环境下的异常问题。但部分用户反映，在多语言环境（如使用django-rosetta）时仍偶有警告，官方表示将在下一个热修复中彻底解决。

行业启示：开源框架的“第一印象”至关重要

本次事件虽非重大安全性漏洞，却折射出开源电子商务框架在版本迭代中容易忽视的“用户首发体验”问题。正如资深Django开发者、TechCrunch撰稿人Sarah K.所评论：“当一个框架的'hello world'都变得困难时，它可能会流失大量潜在用户。django-oscar团队的反应速度值得肯定，但改进测试流程同样迫切。”

对于正在使用或计划使用django-oscar的国内开发团队，建议： - 新项目启动时严格遵循官方最新的安装指南（3.2.2及以上）； - 若遇到类似异常，优先检查OSCAR_SHOP配置与模板路径； - 保持关注官方GitHub Repository的Release Notes，及时升级。

截至记者发稿，django-oscar GitHub仓库的Star数未出现明显下降，社区修复Issue的活跃度反而创下近半年新高。或许正如一位参与修复的贡献者所言：“每一次Bug都是一次让框架变得更好的机会。”