本文旨在解决 django 应用中常见的 404 页面未找到错误，特别是当表单提交或文件上传未能正确路由到视图函数时。我们将详细阐述如何通过正确配置项目级和应用级 `urls.py`、在 `settings.py` 中注册应用，以及规范使用 url 命名空间来解决此类问题，确保请求被正确处理。
当用户在 Django 应用中提交表单，特别是涉及文件上传时，如果服务器返回 404 "Page not found" 错误，通常意味着 Django 的 URL 调度器未能找到与请求 URL 匹配的模式。这种错误提示，例如 Request Method: GET Request URL: http://127.0.0.1:8000/post?file1=f.txt&file2=t.txt，表明了请求的路径 /post 未在项目的 URL 配置中找到对应项。尽管表单可能被设置为 POST 方法并指向一个命名 URL，但错误的配置可能导致请求无法被正确处理，甚至以意外的 GET 请求形式出现。
出现 404 错误，尤其是在表单提交后，通常源于以下几个核心问题：
要解决这类 404 错误并确保 Django 应用的路由机制正常工作，请遵循以下步骤：
首先，确认你已经创建了一个 Django 应用（例如 my_app），并且该应用已在项目的 settings.py 文件中注册。
创建应用（如果尚未创建）：
python manage.py startapp my_app
注册应用（settings.py）：
在项目的 settings.py 文件中，找到 INSTALLED_APPS 列表，并添加你的应用名称。
# project_name/settings.py
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'my_app', # 确保你的应用名称在此处
]项目的 urls.py 位于项目根目录（与 settings.py 同级），它的主要职责是包含各个应用的 URL 模式。使用 django.urls.include 函数将你的应用 URL 模式导入。
# project_name/urls.py
from django.contrib import admin
from django.urls import path, include
urlpatterns = [
path('admin/', admin.site.urls),
# 将所有非 admin 的请求路由到 'my_app' 的 urls.py
# 也可以指定一个前缀，例如 path('app/', include('my_app.urls'))
path('', include('my_app.urls')),
]在你的应用目录（例如 my_app/）中创建一个 urls.py 文件（如果它不存在）。这个文件将定义 my_app 内部的所有 URL 模式。同时，强烈建议设置 app_name 来为应用的 URL 模式提供命名空间，以避免与其他应用发生 URL 名称冲突。
# my_app/urls.py
from django.urls import path
from . import views
app_name = 'my_app' # 定义应用的命名空间
urlpatterns = [
path('', views.home_view, name='home'),
path('login/', views.login_view, name='login'),
path('compare-files/', views.compare_files_view, name='compare-files'), # 文件比较视图的 URL
]在 home.html 或其他模板中，当引用应用内部的 URL 时，应使用 {% url %} 标签结合应用命名空间来确保正确解析。
<!-- my_app/templates/home.html -->
<html>
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Home</title>
</head>
<body>
{% block content %}
{% if user.is_authenticated %}
Yo wassup {{ user.username }}!
<form method="post" action="{% url 'my_app:compare-files' %}" enctype="multipart/form-data">
{% csrf_token %} <!-- 确保包含 CSRF token -->
<br>file 1: <br>
<input type = 'file' name="file1"/>
<br>file 2: <br>
<input type = 'file' name="file2"/>
<br><button type="submit">Compare Files</button>
</form>
{% if result %}
<p>Comparison Result: {{ result }}</p>
{% endif %}
{% else %}
<p>please Login</p>
<a href="{% url 'my_app:login' %}">Login</a>
{% endif %}
{% endblock %}
</body>
</html>确保你的视图函数（例如 compare_files_view）能够正确处理请求方法和文件数据。
# my_app/views.py
from django.shortcuts import render
import xxhash
from django.http import HttpResponse
def home_view(request):
return render(request, 'home.html')
def login_view(request):
# 如果你正在使用 Django 的 LoginView，这个自定义视图可能不需要
return render(request, 'login.html')
def compare_files_view(request):
if request.method == 'POST' and 'file1' in request.FILES and 'file2' in request.FILES:
file1 = request.FILES['file1']
file2 = request.FILES['file2']
result = "Same" if compare_files(file1, file2) else "Different"
return render(request, 'home.html', {'result': result})
else:
# 处理 GET 请求或缺少文件的 POST 请求，可以返回带有错误信息的页面
return render(request, 'home.html', {'error_message': '请上传两个文件进行比较。'})
def compare_files(file1, file2):
# 确保文件对象在读取前被重置到开头，以防之前被读取过
file1.seek(0)
file2.seek(0)
hash1 = xxhash.xxh64(file1.read()).hexdigest()
hash2 = xxhash.xxh64(file2.read()).hexdigest()
return hash1 == hash2Django 中的 404 错误通常是 URL 路由配置问题的直接体现。通过遵循正确的 Django 应用结构，包括创建和注册应用、合理配置项目级和应用级 urls.py，并使用 URL 命名空间来引用 URL，可以有效避免此类问题。理解 Django 的 URL 调度机制是构建健壮和可维护 Web 应用的关键一步。
广告Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
898
收藏
