Django表单提交后Description字段HTML标签丢失问题求解决方案

以下是针对表单提交后HTML标签丢失问题的排查和解决步骤：

1. 确认表单字段配置正确 #

确保ModelForm中对应的description字段没有被自动过滤HTML。直接在表单类中指定字段属性，关闭strip并使用正确的部件：

from django import forms
from .models import YourModel

class YourModelForm(forms.ModelForm):
    description = forms.CharField(
        widget=forms.Textarea(attrs={'rows': 6}),
        strip=False  # 关键：不剥离首尾字符，保留原始标签
    )

    class Meta:
        model = YourModel
        fields = ['description']

如果是通过Meta.widgets配置，记得在__init__方法中显式设置strip=False：

def __init__(self, *args, **kwargs):
    super().__init__(*args, **kwargs)
    self.fields['description'].strip = False

2. 排查全局/模型层的HTML清理逻辑 #

• 检查项目是否使用了django-bleach等第三方清理库，这类库可能会全局拦截并清理用户输入的HTML标签，需要在配置中允许你需要保留的标签（比如<p>、<br>等）。
• 检查模型的save方法是否重写过，若有对description字段做strip()、bleach.clean()或其他转义处理的代码，直接移除这类逻辑。

3. 修正clean_description方法（如果重写过） #

如果你自定义了clean_description方法，确保只做必要的验证，不要对内容进行HTML过滤或转义：

def clean_description(self):
    desc = self.cleaned_data.get('description')
    # 仅做非空等基础验证，不要修改原始内容
    if not desc:
        raise forms.ValidationError("描述内容不能为空")
    return desc

4. 绕过表单clean直接保存原始输入（极端场景） #

如果以上方法都无效，可以在保存时直接读取POST原始数据，绕过表单的clean处理流程：

if form.is_valid():
    instance = form.save(commit=False)
    # 直接从POST获取未被处理的原始内容
    instance.description = self.request.POST.get('description')
    instance.save()

注意：这种方式会跳过表单的安全验证，存在XSS风险，仅适用于信任用户的输入场景，建议后续自行用bleach等工具过滤危险标签。

安全提示 #

允许存储HTML标签时，务必在前端渲染时进行安全过滤，避免XSS攻击。可以使用bleach库只允许合法标签：

{% load bleach_tags %}
{{ object.description|bleach:"p,b,i,br,strong,em" }}

内容的提问来源于stack exchange，提问作者Manoj Kumar M