如何在Google Cloud Functions（Python 3.10）环境中启用多区域设置

问题原因 #

Google Cloud Functions的运行环境是轻量级精简配置，默认仅预装了极少量locale（比如C.UTF-8），locale.locale_alias里的大部分别名对应的locale包并未在环境中安装，因此调用locale.setlocale时会全部报错“unsupported locale setting”。

解决办法 #

1. 直接使用环境已预装的locale

先确认环境里可用的locale，运行以下代码查看：

import locale
# 查看默认locale
print(locale.getdefaultlocale())
# 查看常见可用locale示例
print([alias for alias in locale.locale_alias if alias in ('C.UTF-8', 'en_US.UTF-8')])

通常可以直接用C.UTF-8，示例代码：

import locale
locale.setlocale(locale.LC_TIME, 'C.UTF-8')

2. 自定义构建环境安装所需locale

如果必须用特定locale，需要通过Cloud Build在部署时安装locale包：

• 创建cloudbuild.yaml配置文件，替换YOUR_FUNCTION_NAME为你的函数名：

steps:
- name: 'gcr.io/google.com/cloudsdktool/cloud-sdk:alpine'
  entrypoint: 'bash'
  args:
  - '-c'
  - |
    apk add --no-cache musl-locales musl-locales-lang
    pip install -r requirements.txt -t .
- name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
  entrypoint: 'gcloud'
  args: ['functions', 'deploy', 'YOUR_FUNCTION_NAME', '--runtime', 'python310', '--trigger-http', '--allow-unauthenticated']

• 执行部署命令：

gcloud builds submit --config cloudbuild.yaml .

这个步骤会用Alpine镜像安装musl-locales包（包含常用locale支持），再部署函数。

3. 只使用需要的特定locale

不要遍历locale.locale_alias里的所有条目，直接指定你实际需要的完整locale名称，比如fr_FR.UTF-8，避免尝试那些环境里不存在的locale。

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