Django Rest Framework返回预存JSON文件遇500(TypeError)错误求助

1. 先获取具体错误详情 #

开发模式下（DEBUG=True），直接访问错误页面或查看控制台输出，能看到TypeError的具体触发位置和原因，比如'str' object is not callable或JsonResponse() argument must be a JSON serializable object，这是定位问题的关键。

2. 检查视图函数的常见错误 #

典型错误场景及修复 #

• 直接返回字符串而非响应对象：视图必须返回HttpResponse或其子类（如JsonResponse），如果直接返回文件内容字符串，会触发类型错误。
• 用JsonResponse传入JSON字符串：JsonResponse要求接收Python可序列化对象（字典、列表等），而非JSON格式的字符串，直接传字符串会导致序列化错误。
• 硬编码路径导致文件读取失败：路径拼接错误会引发FileNotFoundError，后续操作可能连锁触发TypeError。

3. 正确实现视图函数 #

以下两种写法均可避免TypeError：

方法一：解析JSON后返回Python对象 #

# register/views.py
import os
import json
from django.conf import settings
from django.http import JsonResponse

def stations_api(request):
    if request.method != 'GET':
        return JsonResponse({'error': '仅支持GET请求'}, status=405)
    
    # 构建文件绝对路径，避免硬编码
    file_path = os.path.join(settings.BASE_DIR, 'register', 'static', 'stations.json')
    try:
        with open(file_path, 'r', encoding='utf-8') as f:
            # 将JSON字符串转为Python对象
            data = json.load(f)
        # 如果返回的是列表，需添加safe=False参数
        return JsonResponse(data, safe=False)
    except FileNotFoundError:
        return JsonResponse({'error': '未找到stations.json文件'}, status=404)
    except json.JSONDecodeError:
        return JsonResponse({'error': 'JSON文件格式无效'}, status=400)

方法二：直接返回文件内容 #

如果不需要解析JSON，可直接返回文件内容并设置正确的响应头：

# register/views.py
import os
from django.conf import settings
from django.http import HttpResponse

def stations_api(request):
    if request.method != 'GET':
        return HttpResponse('{"error": "仅支持GET请求"}', content_type='application/json', status=405)
    
    file_path = os.path.join(settings.BASE_DIR, 'register', 'static', 'stations.json')
    try:
        with open(file_path, 'r', encoding='utf-8') as f:
            content = f.read()
        return HttpResponse(content, content_type='application/json')
    except FileNotFoundError:
        return HttpResponse('{"error": "未找到stations.json文件"}', content_type='application/json', status=404)

4. 验证URL配置正确性 #

应用级register/urls.py #

from django.urls import path
from . import views

urlpatterns = [
    path('api/stations/', views.stations_api, name='stations-api'),
]

项目级setup/urls.py #

from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include('register.urls')),
]

内容的提问来源于stack exchange，提问作者Anish Mittal