在Django项目中使用JSON文件存储站点信息与配置是否合理？

问题1：原实现的合理性与存在的问题 #

• 功能层面可以正常运行，但不属于最优实现，存在多个潜在风险：
  • 硬编码JSON文件路径：Django运行时的工作目录不是固定的，部署后大概率会报文件找不到的错误，建议用BASE_DIR拼接绝对路径，比如os.path.join(BASE_DIR, 'data_file.json')
  • 每次请求触发磁盘IO：单次读文件开销不大，但高并发场景下会直接拉低接口响应速度，还会拉高服务器IO负载
  • 无错误捕获逻辑：如果JSON文件格式错误、被误删、没有读权限，视图会直接抛出异常返回500错误
  • 扩展性差：后续要加新的配置项、或者需要后台可视化修改配置的话，JSON文件的维护成本会非常高

问题2：常用优化方案 #

可以根据自己的业务场景选择以下几种从简到繁的优化方案：

方案1：项目启动时预加载到内存 #

适合配置修改频率极低，不需要热更新的场景，项目启动时仅读一次文件存到内存，后续请求直接读取内存数据：

1. 新建config.py文件写入预加载逻辑：

import json
import os
from django.conf import settings

# 项目启动时仅执行一次读取
SITE_CONFIG = {}
config_path = os.path.join(settings.BASE_DIR, 'data_file.json')
try:
    with open(config_path, 'r', encoding='utf-8') as f:
        SITE_CONFIG = json.load(f)
except Exception as e:
    # 可自行添加日志告警，避免异常中断启动
    print(f"站点配置加载失败：{e}")

2. 视图中直接导入使用：

from .config import SITE_CONFIG
from django.shortcuts import render

def about(request):
    context = {
        "about_us_text": SITE_CONFIG.get('about_text', '')
    }
    return render(request, 'about.html', context)

如果需要支持热更新，可以额外加一个权限校验后的重载接口，调用后重新读取文件更新SITE_CONFIG变量即可。

方案2：用Django自带缓存框架存储 #

适合配置需要定时更新，不想改启动逻辑的场景，读配置时优先走缓存，缓存过期再重新读文件：

import json
import os
from django.conf import settings
from django.core.cache import cache
from django.shortcuts import render

def about(request):
    # 优先读缓存
    site_config = cache.get('site_config')
    if not site_config:
        config_path = os.path.join(settings.BASE_DIR, 'data_file.json')
        try:
            with open(config_path, 'r', encoding='utf-8') as f:
                site_config = json.load(f)
            # 缓存1小时，可根据需求调整时长
            cache.set('site_config', site_config, 3600)
        except Exception as e:
            site_config = {}
    context = {
        "about_us_text": site_config.get('about_text', '')
    }
    return render(request, 'about.html', context)

方案3：改用数据库存储配置 #

适合需要后台可视化修改配置的场景，新建配置表配合Django Admin即可实现无代码修改配置，同样可以加缓存降低数据库查询压力：
模型示例：

from django.db import models

class SiteConfig(models.Model):
    key = models.CharField(max_length=50, unique=True, verbose_name="配置键")
    value = models.TextField(verbose_name="配置值")
    remark = models.CharField(max_length=100, blank=True, verbose_name="备注")

    class Meta:
        verbose_name = "站点配置"
        verbose_name_plural = verbose_name

读取逻辑和方案2类似，把读文件的逻辑换成查询数据库即可。

内容的提问来源于stack exchange，提问作者Ali Nazari