Django I18n在Google App Engine标准环境无法加载翻译目录

核心问题排查与修复 #

1. 翻译文件路径与GAE只读文件系统的冲突 #

GAE标准环境里，除/tmp/外所有目录都是只读的。如果你的.mo/.po翻译文件放在应用目录（比如locale/），虽然部署时会上传，但Django默认可能尝试往该目录写入缓存文件，直接导致翻译无法加载。

解决步骤：

• 修改settings.py的LOCALE_PATHS，把翻译缓存路径指向/tmp/：

import os
LOCALE_PATHS = [
    os.path.join('/tmp', 'locale'),
    # 保留原locale目录作为源文件路径
    os.path.join(BASE_DIR, 'locale'),
]

• 部署时确保locale/目录被包含在部署包（app.yaml不要排除它），然后在应用启动时把翻译文件复制到/tmp/locale/，可以在wsgi.py或asgi.py开头加这段逻辑：

import shutil
import os
from django.conf import settings

def copy_locale_files():
    src_locale = os.path.join(settings.BASE_DIR, 'locale')
    dest_locale = os.path.join('/tmp', 'locale')
    if not os.path.exists(dest_locale):
        shutil.copytree(src_locale, dest_locale)
    # 源文件更新时自动覆盖目标文件
    else:
        for root, dirs, files in os.walk(src_locale):
            rel_path = os.path.relpath(root, src_locale)
            dest_root = os.path.join(dest_locale, rel_path)
            os.makedirs(dest_root, exist_ok=True)
            for file in files:
                src_file = os.path.join(root, file)
                dest_file = os.path.join(dest_root, file)
                if not os.path.exists(dest_file) or os.path.getmtime(src_file) > os.path.getmtime(dest_file):
                    shutil.copy2(src_file, dest_file)

# 应用启动前执行复制
copy_locale_files()

2. GAE缓存机制的影响 #

GAE会缓存应用文件，可能导致新翻译文件无法被加载。

解决步骤：

• 在app.yaml里给翻译目录加版本标识：

env_variables:
  LOCALE_VERSION: "v1"

• 修改复制脚本和LOCALE_PATHS，把版本号加入路径避免缓存：

# 复制脚本里的目标路径
import os
from django.conf import settings

LOCALE_VERSION = os.environ.get('LOCALE_VERSION', 'v1')
dest_locale = os.path.join('/tmp', f'locale_{LOCALE_VERSION}')

# settings.py里的LOCALE_PATHS
LOCALE_PATHS = [
    os.path.join('/tmp', f'locale_{LOCALE_VERSION}'),
    os.path.join(BASE_DIR, 'locale'),
]

3. Django翻译缓存配置 #

Django默认会缓存翻译内容，GAE环境下可能因为权限问题无法写入缓存，导致翻译不生效。

解决步骤：

• 在settings.py里要么禁用翻译缓存，要么把缓存目录指向/tmp/：

# 方案1：禁用翻译缓存
USE_I18N = True
USE_L10N = True

# 方案2：设置缓存到/tmp目录
import os
CACHES = {
    'default': {
        'BACKEND': 'django.core.cache.backends.filebased.FileBasedCache',
        'LOCATION': os.path.join('/tmp', 'django_cache'),
    }
}

验证方法 #

• 部署后查看GAE日志，检查是否有Permission denied这类权限错误
• 在视图里加调试代码，确认翻译文件路径和存在状态：

from django.http import HttpResponse
from django.utils.translation import gettext_lazy as _
import os
from django.conf import settings

def test_translation(request):
    # 打印所有翻译路径及文件
    for locale_path in settings.LOCALE_PATHS:
        print(f"检查路径: {locale_path}")
        print(f"目录文件: {os.listdir(locale_path) if os.path.exists(locale_path) else '路径不存在'}")
    # 测试翻译输出
    return HttpResponse(_("Hello World"))

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