使用Dockerfile时遭遇update-locale: invalid locale settings错误

问题原因 #

报错核心在于：执行update-locale时，虽已通过locale-gen生成fr_FR.UTF-8，但当前构建阶段的shell未正确加载新生成的locale，同时提前设置的ENV变量与update-locale的配置逻辑冲突，导致命令识别无效的locale设置。

解决方案 #

方案1：移除多余的update-locale命令 #

Debian/Ubuntu系镜像中，只要通过locale-gen生成目标locale，再用ENV全局设置locale变量即可生效，无需额外执行update-locale。修改后的Dockerfile片段如下：

WORKDIR /app

RUN apt-get update && apt-get install -y \
    build-essential \
    curl \
    software-properties-common \
    git \
    locales \
    && rm -rf /var/lib/apt/lists/*

RUN locale-gen fr_FR.UTF-8

ENV LANG=fr_FR.UTF-8
ENV LANGUAGE=fr_FR:fr
ENV LC_ALL=fr_FR.UTF-8

COPY . .

RUN pip3 install -r requirements.txt

方案2：合并locale生成与配置命令（若需保留update-locale） #

将locale-gen和update-locale放在同一个RUN命令中，临时加载生成的locale后再执行配置，避免环境变量冲突：

WORKDIR /app

RUN apt-get update && apt-get install -y \
    build-essential \
    curl \
    software-properties-common \
    git \
    locales \
    && rm -rf /var/lib/apt/lists/*

RUN locale-gen fr_FR.UTF-8 && \
    export LANG=fr_FR.UTF-8 && \
    update-locale LANG=fr_FR.UTF-8

ENV LANG=fr_FR.UTF-8
ENV LANGUAGE=fr_FR:fr
ENV LC_ALL=fr_FR.UTF-8

COPY . .

RUN pip3 install -r requirements.txt

验证逻辑 #

修改后重新构建镜像，locale-gen负责生成指定的locale文件，ENV命令会将locale变量注入后续所有容器运行阶段的环境中，确保应用和系统工具都能识别并使用fr_FR.UTF-8 locale。

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