Django中错误翻译操作的日志记录方案咨询

1. 编写语言环境未初始化时的gettext包装函数完全可行 #

这种方案直接有效，核心思路是在调用原生gettext前先检查当前语言环境是否存在（通过get_language() is None判断），如果不存在则记录错误日志甚至抛出异常，帮助快速定位误用场景。

示例实现：

import logging
from django.utils.translation import gettext as original_gettext
from django.utils.translation import get_language

logger = logging.getLogger(__name__)

def safe_gettext(message):
    if get_language() is None:
        # 开发环境可抛出异常强制排查，生产环境仅记录日志
        logger.error(
            "调用gettext时未初始化语言环境，请考虑替换为gettext_lazy",
            stack_info=True  # 记录调用栈，方便定位代码位置
        )
        # raise RuntimeError("语言环境未初始化，禁止调用gettext，建议使用gettext_lazy")
    return original_gettext(message)

可以根据环境切换行为：开发环境抛出异常，能第一时间发现问题；生产环境仅记录日志，避免影响服务运行。

2. 统一使用包装函数的优雅方案（避免猴子补丁） #

有两种主流方式可以实现统一接入，无需修改原生代码或使用猴子补丁：

方式一：自定义翻译模块，统一导入 #

在项目中创建自定义翻译模块，包装gettext并导出原模块的其他翻译工具，要求项目内所有代码统一导入这个自定义模块，而非直接导入Django的translation模块。

示例代码：

# 项目根目录/translation.py
from django.utils.translation import *  # 导入原模块所有工具（gettext_lazy、pgettext等）
from django.utils.translation import gettext as original_gettext
import logging

logger = logging.getLogger(__name__)

def gettext(message):
    if get_language() is None:
        logger.error(
            "调用gettext时未初始化语言环境，建议替换为gettext_lazy",
            stack_info=True
        )
    return original_gettext(message)

# 按需包装其他可能误用的函数，比如pgettext
def pgettext(context, message):
    if get_language() is None:
        logger.error(
            "调用pgettext时未初始化语言环境，建议替换为pgettext_lazy",
            stack_info=True
        )
    from django.utils.translation import pgettext as original_pgettext
    return original_pgettext(context, message)

项目中所有需要使用翻译的地方，统一导入：

from translation import gettext, gettext_lazy

这种方式对代码侵入性低，只需统一导入规则即可。

方式二：自定义翻译后端，全局生效 #

利用Django支持自定义翻译后端的机制，继承原生翻译后端并重写gettext方法，加入检测逻辑，然后在配置中指定使用自定义后端，这样所有调用Django原生gettext的地方都会自动触发检测。

示例代码：

# 项目根目录/translation_backend.py
from django.utils.translation.trans_real import Translation as OriginalTranslation
import logging

logger = logging.getLogger(__name__)

class SafeTranslationBackend(OriginalTranslation):
    def gettext(self, message):
        if self.get_language() is None:
            logger.error(
                "调用gettext时未初始化语言环境，应使用gettext_lazy",
                stack_info=True
            )
        return super().gettext(message)

    # 可选：重写其他方法，比如pgettext
    def pgettext(self, context, message):
        if self.get_language() is None:
            logger.error(
                "调用pgettext时未初始化语言环境，应使用pgettext_lazy",
                stack_info=True
            )
        return super().pgettext(context, message)

在settings.py中配置自定义后端：

TRANSLATION_BACKEND = "translation_backend.SafeTranslationBackend"

这种方式无需修改任何导入代码，全局生效，是最优雅的方案。

额外辅助：静态代码检查 #

配合flake8等静态检查工具，编写自定义规则，检测是否在模型定义、全局变量声明等语言环境未初始化的场景中使用了gettext，提前在编码阶段发现问题。

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