Docker运行Python应用时遭遇巴西本地化货币格式报错

问题原因 #

Docker默认基础镜像通常仅配置C（POSIX）locale，而locale.currency方法需要支持货币格式化的locale环境（如巴西葡萄牙语的pt_BR.UTF-8），这是触发报错的核心原因。本地系统因已配置巴西时区对应的locale，所以能正常运行。

解决方案 #

以下是几种可行的解决方式，可根据你的镜像类型选择：

1. 在Dockerfile中安装并配置目标locale #

若使用Debian/Ubuntu系镜像（如python:3.11-slim），在Dockerfile中添加以下步骤：

• 安装locale相关工具及目标locale包
• 生成并设置默认locale为pt_BR.UTF-8

示例Dockerfile片段：

# 安装locale依赖
RUN apt-get update && apt-get install -y --no-install-recommends locales && \
    rm -rf /var/lib/apt/lists/*

# 启用并生成巴西葡萄牙语locale
RUN sed -i '/pt_BR.UTF-8/s/^# //g' /etc/locale.gen && \
    locale-gen pt_BR.UTF-8

# 设置全局locale环境变量
ENV LANG pt_BR.UTF-8
ENV LC_ALL pt_BR.UTF-8
ENV LC_MONETARY pt_BR.UTF-8

2. 在Python代码中显式设置locale（或自定义格式化） #

若不想修改Docker镜像，可在代码开头直接指定所需locale；若镜像未预装该locale，可自定义货币格式化函数作为降级方案：

import locale

# 尝试设置巴西葡萄牙语locale
try:
    locale.setlocale(locale.LC_MONETARY, 'pt_BR.UTF-8')
    # 原代码可正常使用
    currency_str = locale.currency(float("%.2f" % pmt_value), grouping=True, symbol="R$")
except locale.Error:
    # 自定义货币格式化，适配巴西格式
    def custom_currency(value):
        # 保留两位小数并添加千分位分隔符，替换为巴西格式的逗号/点号
        formatted = f"R$ {value:,.2f}"
        return formatted.replace(',', '|').replace('.', ',').replace('|', '.')
    currency_str = custom_currency(float("%.2f" % pmt_value))

3. 通过Docker Compose设置环境变量（需镜像已预装目标locale） #

如果镜像已包含pt_BR.UTF-8 locale，直接在docker-compose.yml中添加环境变量配置：

services:
  your-service-name:
    environment:
      - LANG=pt_BR.UTF-8
      - LC_ALL=pt_BR.UTF-8
      - LC_MONETARY=pt_BR.UTF-8
    # 其他服务配置...

验证方式 #

启动容器后，进入容器执行以下命令，检查LC_MONETARY是否显示为pt_BR.UTF-8：

locale

内容的提问来源于stack exchange，提问作者Márcio Scotuzzi Jr.