PostgreSQL升级遇‘请求的区域设置无效’错误排查与疑问

问题场景 #

尝试使用pg_upgradecluster 13 main将PostgreSQL 13集群升级至15版本，持续触发locale相关错误；已检查当前用户、postgres用户的locale输出，以及/etc/default/locale配置，均显示LC_CTYPE=en_US.UTF-8，且执行dpkg-reconfigure locales将en_US.UTF-8设为系统默认后，问题依旧。最终通过在命令前强制指定环境变量完成升级，但疑惑标准Debian系统为何需要此操作。

报错详情 #

Stopping old cluster...
Restarting old cluster with restricted connections...
Notice: extra pg_ctl/postgres options given, bypassing systemctl for start operation
perl: warning: Setting locale failed.
perl: warning: Please check that your locale settings:
    LANGUAGE = (unset),
    LC_ALL = (unset),
    LC_CTYPE = "UTF-8",
    LANG = "en_US.UTF-8"
    are supported and installed on your system.
perl: warning: Falling back to a fallback locale ("en_US.UTF-8").
Error: The locale requested by the environment is invalid:
  LANG: en_US.UTF-8
  LC_CTYPE: UTF-8
Error: Could not create target cluster

临时解决方法 #

执行以下命令强制覆盖环境变量，即可完成升级：

env -i LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8 LC_CTYPE=en_US.UTF-8 pg_upgradecluster 13 main

原因解析 #

1. sudo环境变量过滤：Debian默认的sudo配置（/etc/sudoers中的env_reset选项）会重置部分环境变量，导致执行pg_upgradecluster时，LC_CTYPE被意外设置为不完整的UTF-8（而非标准的en_US.UTF-8），系统无法识别这个无效的locale名称。
2. 服务环境变量隔离：pg_upgradecluster在操作过程中会绕过systemctl启动集群，此时子进程可能无法正确加载/etc/default/locale中的系统默认locale配置，继承了错误的环境变量。
3. 隐性环境变量冲突：当前用户的shell环境中locale配置正确，但pg_upgradecluster调用的perl脚本或postgres子进程可能继承了其他来源的错误locale变量（比如某些服务的启动环境），导致检测到无效的LC_CTYPE=UTF-8。

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