Django视图函数异常：提交百科条目跳转至error页面问题排查

问题核心 #

提交新条目后跳转至error.html，说明converter()函数判断传入的标题不在条目列表中，本质是新保存的条目未被list_entries()检测到。

排查步骤 #

先通过打印调试信息定位根因，在views.py的save()和converter()函数中添加日志：

def save(request):
    if request.method == 'POST':
        title = request.POST.get('title','').strip()
        content = request.POST.get('content', '')
        entry = util.list_entries()

        # 打印调试信息
        print(f"[Save] 接收的标题: '{title}'")
        print(f"[Save] 现有条目列表: {entry}")

        if title in entry:
            return render(request, "encyclopedia/exists.html")
        else:
            util.save_entry(title, content)
            print(f"[Save] 保存后条目列表: {util.list_entries()}")
            return converter(request, title)

def converter(request, title):
    entry = util.list_entries()
    # 打印调试信息
    print(f"[Converter] 接收的标题: '{title}'")
    print(f"[Converter] 条目列表: {entry}")
    
    markdowner = Markdown()
    if title in entry:
        content = util.get_entry(title)
        data = markdowner.convert(content)
        return render(request, "encyclopedia/entry.html", {
            "data": data
        })
    else:
        print(f"[Converter] 标题 '{title}' 未找到")
        return render(request, "encyclopedia/error.html")

运行应用并提交新条目，查看控制台日志，重点关注：

1. 接收的标题是否与预期一致（是否有多余空格、特殊字符）
2. 保存后条目列表是否包含新标题
3. 转换器接收的标题是否与保存的标题一致

常见问题及解决方案 #

1. 标题包含前后空格 #

用户输入的标题带有前后空格，导致保存的文件名包含空格，而判断时未处理空格，导致匹配失败。
解决：获取标题时自动去除前后空格：

title = request.POST.get('title','').strip()

2. 大小写不匹配 #

比如用户输入python，但系统中已有Python.md文件（Windows系统文件名不区分大小写，但list_entries()返回原大小写），导致标题判断不匹配。
解决：统一标题大小写，例如全部转为小写后处理：

# save函数中
title = request.POST.get('title','').strip().lower()
# save_entry函数中（util.py）
filename = f"entries/{title}.md"
# 判断时统一大小写
if any(e.lower() == title.lower() for e in entry):
    # 条目已存在逻辑

3. 文件未实际保存（权限/目录问题） #

检查entries目录是否存在，且Django进程有读写权限：

• 手动创建entries目录（如果不存在）
• 调整目录权限，确保Django能写入文件

4. 存储后端缓存延迟 #

如果使用S3等远程存储后端，listdir()可能存在缓存，导致新文件无法立即被检测到。
解决：测试阶段先使用本地文件系统存储，或调用存储后端的刷新缓存接口（若支持）。

额外优化建议 #

在save_entry()中添加目录创建逻辑，避免因目录不存在导致保存失败：

# util.py
def save_entry(title, content):
    filename = f"entries/{title}.md"
    # 确保entries目录存在
    if not default_storage.exists("entries"):
        default_storage.makedirs("entries")
    if default_storage.exists(filename):
        default_storage.delete(filename)
    default_storage.save(filename, ContentFile(content))

内容的提问来源于stack exchange，提问作者anshith S.Kumar