本文深入探讨了在django与apache集成环境下，进行文件上传时遇到的404错误和前端json解析异常。核心问题在于后端视图在处理请求时可能发生未捕获的异常，导致服务器返回html错误页面而非预期的json响应。教程将详细介绍如何通过在django视图中实现健壮的异常捕获机制，确保即使发生错误也能返回规范的json错误信息，从而有效解决前端解析失败的问题，并提供相关代码示例及调试建议。
在进行Web开发时，前端通过fetch API向后端发送请求，并期望获得JSON格式的响应。当遇到“Error 404 (Not Found)”和“SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON”这类错误时，通常意味着以下两个核心问题：
综合来看，最常见的情况是：请求抵达了服务器（可能是Apache或Django），但由于某种原因（路由不匹配、视图内部异常等），服务器没有返回预期的JSON响应，而是返回了一个HTML错误页面。前端的fetch请求在.then(response => response.json())这一步尝试解析HTML，从而引发了JSON解析异常。
以下是前端用于上传头像的JavaScript代码片段，它通过FormData发送POST请求，并期望后端返回JSON数据。
PhotoUpload.addEventListener('change', function() {
const file = this.files[0];
if (file) {
const reader = new FileReader();
reader.addEventListener('load', function() {
// ... 图片预览逻辑 ...
const formData = new FormData();
formData.append('photo', file);
fetch('/upload-avatar/', {
method: 'POST',
body: formData
})
.then(response => response.json()) // 期望JSON响应
.then(data => {
console.log(data);
})
.catch(error => {
console.error('Error:', error); // 捕获错误，包括JSON解析错误
});
});
reader.readAsDataURL(file);
} else {
// ... 占位符逻辑 ...
}
});可以看到，fetch请求的.then(response => response.json())明确指示了前端期望JSON格式的响应。一旦后端返回非JSON内容，此处就会抛出SyntaxError。
原始的Django视图和URL配置如下：
views.py
from django.shortcuts import render
from django.views.decorators.csrf import csrf_exempt
from django.core.files.storage import default_storage
from django.http import JsonResponse
@csrf_exempt
def upload_avatar(request):
if request.method == 'POST' and request.FILES.get('photo'):
photo = request.FILES['photo']
# Сохраните фотографию с помощью default_storage
filename = default_storage.save('photos/' + photo.name, photo)
return JsonResponse({'message': f'Photo uploaded successfully: {filename}'})
return JsonResponse({'error': 'An error occurred while uploading the photo.'})urls.py
from django.contrib import admin
from django.urls import path
from django.conf import settings
from django.conf.urls.static import static
from PhotoSave import views
urlpatterns = [
path('admin/', admin.site.urls),
path('upload-avatar/', views.upload_avatar, name='upload_avatar'),
]
urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)在这个views.py中，upload_avatar函数在处理POST请求并获取到文件后，尝试使用default_storage.save保存文件。如果在这个保存过程中发生任何异常（例如，文件系统权限问题、default_storage配置错误等），由于没有显式的try-except块来捕获这些异常，Django将抛出未处理的异常。在开发模式下，这可能导致返回详细的HTML错误页面；在生产模式下，则可能返回一个通用的500错误HTML页面，或者由Apache捕获并返回其自身的错误页面。这些HTML页面都会触发前端的JSON解析异常。
@csrf_exempt装饰器用于豁免CSRF保护，允许POST请求无需CSRF令牌即可提交，但这与当前的404及JSON解析错误并非直接相关。
提供的Apache httpd.conf片段显示了mod_wsgi模块的加载以及对特定目录的权限设置：
<Directory "${SRVROOT}/cgi-bin">
AllowOverride None
Options None
Require all granted
</Directory>
<Directory "${INSTALL_DIR}/www/Chat/MediaSave">
Options Indexes FollowSymLinks
AllowOverride None
Require all granted
</Directory>以及：
LoadModule wsgi_module modules/mod_wsgi.so
这些配置是Django通过mod_wsgi在Apache上运行的基础。如果mod_wsgi未正确配置，或者WSGIScriptAlias等指令缺失或错误，请求可能根本不会到达Django，从而导致Apache返回404。然而，由于前端收到了以<!DOCTYPE开头的响应，这暗示了请求可能已经到达了某个Web服务器（无论是Apache还是Django），并由其返回了一个HTML页面。在这种情况下，虽然Apache配置是部署的关键，但SyntaxError更直接地指向了Django视图内部未处理的异常。
解决此类问题的核心在于确保Django视图在任何情况下都能返回预期的JSON响应，即使是发生错误时。这需要引入异常处理机制。
优化后的views.py代码
from django.shortcuts import render
from django.views.decorators.csrf import csrf_exempt
from django.core.files.storage import default_storage
from django.http import JsonResponse
import logging
# 获取一个logger实例
logger = logging.getLogger(__name__)
@csrf_exempt
def upload_avatar(request):
if request.method == 'POST' and request.FILES.get('photo'):
try:
photo = request.FILES['photo']
# 建议对文件名进行处理，例如生成唯一文件名，以避免冲突
# filename = default_storage.save('photos/' + photo.name, photo)
# 示例：生成唯一文件名
import os
from django.utils import timezone
timestamp = timezone.now().strftime("%Y%m%d%H%M%S")
original_filename = photo.name
name, ext = os.path.splitext(original_filename)
unique_filename = f"photos/{name}_{timestamp}{ext}"
filename = default_storage.save(unique_filename, photo)
# 返回成功的JSON响应，并可选择返回文件的URL
return JsonResponse({'message': f'Photo uploaded successfully: {filename}', 'file_url': default_storage.url(filename)}, status=200)
except Exception as ex:
# 捕获所有可能的异常，并返回JSON格式的错误信息
logger.error(f"Error uploading avatar: {ex}", exc_info=True) # 记录详细错误日志
return JsonResponse({'error': f'An error occurred while uploading the photo: {str(ex)}'}, status=500)
# 如果不是POST请求或没有文件，返回错误信息
return JsonResponse({'error': 'Invalid request or no photo provided.'}, status=400)
代码改进说明：
当遇到前端JSON解析错误和404时，这通常是后端未能返回预期的JSON响应，而是返回了HTML错误页面的信号。通过在Django视图中实现全面的异常捕获机制，并确保在任何情况下都返回规范的JSON响应（包括成功和失败），可以有效解决此类问题。同时，结合服务器日志和浏览器开发者工具进行调试，是快速定位和解决问题的关键。在部署到生产环境时，务必关闭Django的DEBUG模式，并确保错误信息被妥善记录，以便后续排查。
以上就是Django与Apache集成中文件上传的404及JSON解析异常处理的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
312
收藏
