Django导入模型页面自定义错误展示：隐藏堆栈追踪

一、彻底隐藏生产环境的堆栈追踪 #

1. 关闭DEBUG模式 #

生产环境必须确保settings.py中DEBUG = False，这是基础配置——Django默认在DEBUG关闭时不会向用户展示堆栈追踪，但如果自定义导入视图的异常未处理到位，可能仍会泄露，需配合以下方法。

2. 自定义异常处理中间件 #

如果导入操作的视图抛出的异常未被正确捕获，可添加中间件统一处理生产环境的异常：

# myapp/middleware.py
from django.http import HttpResponseServerError
import logging
from django.conf import settings

class HideStacktraceMiddleware:
    def __init__(self, get_response):
        self.get_response = get_response
        self.logger = logging.getLogger(__name__)

    def __call__(self, request):
        response = self.get_response(request)
        return response

    def process_exception(self, request, exception):
        if not settings.DEBUG:
            # 将堆栈追踪记录到后台日志，仅向用户返回错误信息
            self.logger.exception("服务器异常")
            # 可根据需求改为返回自定义错误页面
            return HttpResponseServerError(f"操作失败：{str(exception)}")
        return None

随后在settings.py的MIDDLEWARE中注册该中间件：

MIDDLEWARE = [
    # 其他中间件保持原有顺序，此中间件可放在末尾
    'myapp.middleware.HideStacktraceMiddleware',
]

3. 针对django-import-export的模板修改（若使用该库） #

如果导入功能基于django-import-export实现，其默认模板会在验证失败时展示堆栈追踪，需正确重写模板：

• 找到库自带的import.html模板（路径一般为site-packages/import_export/templates/admin/import_export/）
• 将该模板复制到项目的templates/admin/import_export/目录下
• 修改模板中的错误展示部分，删除{{ traceback }}等输出堆栈追踪的代码，仅保留错误信息展示逻辑。

二、展示CSV/XLSX受影响行的错误列表 #

若使用django-import-export，可通过自定义资源类收集每行错误，再传递到模板展示：

1. 自定义资源类收集行错误 #

# myapp/resources.py
from import_export import resources
from myapp.models import YourModel
from django.core.exceptions import ValidationError
from django.shortcuts import get_current_request

class YourModelResource(resources.ModelResource):
    class Meta:
        model = YourModel

    def before_import(self, dataset, using_transactions, dry_run, **kwargs):
        super().before_import(dataset, using_transactions, dry_run, **kwargs)
        self.row_errors = []
        # 遍历每行数据，行号从1开始对应文件中的实际行号
        for row_idx, row in enumerate(dataset.dict, start=1):
            try:
                # 这里添加你的自定义验证逻辑
                if not row.get('required_field'):
                    raise ValidationError("必填字段不能为空")
                # 其他验证规则...
            except ValidationError as e:
                self.row_errors.append((row_idx, str(e)))

    def after_import(self, dataset, result, using_transactions, dry_run, **kwargs):
        # 将错误列表存入session，供模板读取
        request = get_current_request()
        request.session['import_row_errors'] = self.row_errors

2. 修改模板展示错误列表 #

在重写的import.html模板中添加以下代码：

{% if request.session.import_row_errors %}
    <div class="errornote">
        <h3>导入错误</h3>
        <ul>
            {% for row_idx, error in request.session.import_row_errors %}
                <li>第{{ row_idx }}行：{{ error }}</li>
            {% endfor %}
        </ul>
    </div>
    {# 展示后清除session中的错误，避免重复显示 #}
    {% request.session.pop('import_row_errors', None) %}
{% endif %}

三、排查模板重写未生效的问题 #

若之前重写import.html无效果，检查以下几点：

• 模板路径是否正确：必须为templates/admin/import_export/import.html，与库的模板路径完全对应
• settings.py的TEMPLATES配置：确保APP_DIRS = True，或DIRS包含你的模板目录
• 清除缓存：生产环境重启服务，开发环境可开启DEBUG模式自动刷新模板，或手动清除Django缓存

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