Django项目中MaxMind DB文件的最佳使用方式咨询

结论：绝对不要每次请求都打开MMDB文件 #

每次请求打开90MB的文件会带来巨大的IO开销，不仅拖慢请求响应速度，还会快速消耗系统文件描述符，长期运行必然触发资源限制，完全不符合你每秒50次请求的性能需求。正确的做法是每个Gunicorn Worker启动时仅加载一次MMDB文件，在内存中复用。

两种方案的对比 #

方案一（错误）：每次请求打开文件

with maxminddb.open_database('GeoLite2-City.mmdb') as mmdb:
    info = mmdb.get('152.216.7.110')
    return Response({'city': info.city, 'other': 'some_other_information_about_ip'})

• 问题：每秒50次请求意味着每秒要执行50次文件打开、读取、关闭操作，IO延迟会直接导致请求响应变慢；同时频繁创建文件描述符，极易触发系统进程的文件描述符上限。

方案二（优化实现）：Worker启动时初始化文件

不建议直接在settings.py中初始化，因为Gunicorn的每个Worker是独立进程，settings.py会被每个Worker加载一次，放在settings里不够规范。更合理的方式是借助Django的AppConfig在Worker启动时初始化。

推荐实现代码：

1. 创建一个自定义App（比如geoip），在geoip/apps.py中初始化MMDB：

from django.apps import AppConfig
import maxminddb

class GeoIPConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'geoip'
    mmdb_instance = None

    def ready(self):
        # 仅在Worker启动时执行一次初始化
        self.mmdb_instance = maxminddb.open_database('GeoLite2-City.mmdb')

2. 在settings.py中将geoip加入INSTALLED_APPS

3. 在Views中调用：

from geoip.apps import GeoIPConfig

def ip_info_view(request):
    client_ip = request.META.get('REMOTE_ADDR')
    mmdb = GeoIPConfig.mmdb_instance
    ip_info = mmdb.get(client_ip)
    return Response({
        'city': ip_info.city.name if ip_info.city else None,
        'other': 'some_other_information_about_ip'
    })

你的担忧解答 #

1. 多个Worker同时读取文件是否冲突？
   完全不会。MMDB文件是只读资源，多个进程同时读取同一只读文件是操作系统允许的安全操作，MaxMind的Python库本身也针对只读场景做了线程/进程安全优化，不会出现数据冲突或读取异常。

2. 应用故障时文件描述符能否正常关闭？
   没问题。如果Worker进程崩溃，操作系统会自动回收该进程占用的所有文件描述符；如果是正常重启Gunicorn，Worker退出时MMDB对象会被Python垃圾回收机制自动清理，文件描述符会正常关闭，不会出现泄漏。

3. Django应用将文件驻留内存的最佳实践

• 只读资源（如MMDB、静态配置缓存）应在Worker启动时初始化，而非请求时，确保每个Worker仅加载一次，复用内存中的副本。
• 避免在settings.py中存放大型对象，推荐用AppConfig或模块级初始化的方式管理全局资源，保持配置文件的简洁性。
• 当MMDB文件需要更新时，必须重启Gunicorn Worker，因为每个Worker加载的是内存中的副本，重启后才会读取新的文件内容。

内容的提问来源于stack exchange，提问作者Michael Matsaev