Wagtail默认模板in_preview_panel开发正常生产环境报错

1. in_preview_panel的作用 #

这个属性是Wagtail专为后台预览场景添加的标记：当你在Wagtail后台编辑页面时，打开「实时预览」面板，Wagtail会给当前请求对象附加in_preview_panel=True，这段模板代码的作用就是让预览面板里的所有链接都在新标签页打开，防止用户点击链接后跳离编辑页面，丢失未保存的内容。

2. 开发/生产环境差异的原因 #

开发环境正常是因为你大概率是通过Wagtail后台预览触发的请求，且Wagtail的核心中间件已正确加载；生产环境报错的核心原因是：

你的生产环境Django配置中缺少Wagtail的SiteMiddleware

这个中间件是Wagtail处理站点请求的核心组件，负责给request对象添加站点相关的属性（包括in_preview_panel）。如果没配置这个中间件，前台请求的request对象就没有这个属性，模板直接访问request.in_preview_panel就会抛出AttributeError。

3. 解决方案 #

方案一：修复生产环境中间件配置 #

在settings.py的MIDDLEWARE列表中添加Wagtail的核心中间件：

MIDDLEWARE = [
    # ... 其他中间件 ...
    'wagtail.core.middleware.SiteMiddleware',
]

注意：这个中间件通常需要放在Django的CommonMiddleware之后，确保站点上下文正确初始化。

方案二：修改模板代码兼容无属性场景 #

如果不想调整中间件，或者需要兼容特殊部署场景，可以在模板里先判断属性是否存在，避免报错：

{% if request|hasattr:"in_preview_panel" and request.in_preview_panel %}
<base target="_blank">
{% endif %}

这样即使request没有这个属性，模板也不会抛出错误，同时保留后台预览的功能。

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