启动应用程序前验证 Python 环境设置

使用声明的契约解析端口

下面的标准库示例接受字符串或 None。它使用 int 进行十进制整数转换，并检查 1 到 65535 的闭区间范围。固定的消息标识问题，但不回显提供的值。范围验证并不能证明端口可用，也不能证明进程有权限绑定它。

将缺失设置与空设置区分开

不带默认参数时，os.getenv("PORT") 在 PORT 缺失时返回 None。如果变量存在但值为空，则返回空字符串。当这两种状态含义不同时，请分别检查它们。例如，缺失的可选端口可能使用默认值，而显式为空的必需设置应产生配置错误。

除非策略有意将所有空字符串视为缺失，否则避免使用 raw 或 default_value 来选择默认值。将设置读入局部变量一次，以便解析、错误报告和后续应用程序启动使用相同的值。

def parse_port(raw):
    if raw is None:
        raise ValueError("PORT is missing")
    if not isinstance(raw, str):
        raise TypeError("PORT must be text")
    if not raw.strip():
        raise ValueError("PORT is empty")
    try:
        port = int(raw)
    except ValueError:
        raise ValueError("PORT must be an integer") from None
    if not 1 <= port <= 65535:
        raise ValueError("PORT is outside 1..65535")
    return port

for sample in ("8080", None, "", "wrong", "65536"):
    try:
        print(parse_port(sample))
    except ValueError as error:
        print(error)

正确解读示例结果

追踪提供的输入会得到 8080，然后是 PORT is missing、PORT is empty、PORT must be an integer，以及 PORT is outside 1..65535。这些是所示逻辑的预期结果，而不是已执行的部署测试报告。int 也接受某些文本形式，例如周围的空白；如果应用程序契约需要更严格的词法规则，请添加它。

对于实际进程，导入 os 并将 os.getenv("PORT") 传递给函数。将选择可选默认值的策略保留在解析器之外，以便明确缺失的必需设置是否应停止启动。

显式解释布尔值

bool("false") 是 True，因为非空字符串是真值。相反，规范化受支持的文本表示，并在显式映射中查找它。可以将 true、yes、on 和 1 视为真，false、no、off 和 0 视为假；拒绝其他字符串，而不是静默启用功能。

ConfigParser.getboolean(section, option) 为 ConfigParser 对象中的选项提供此类转换。它不会自动转换从 os.getenv 获取的字符串。这些是独立的接口。

在开始有用工作之前验证

在连接数据库、打开监听套接字或启动后台作业之前，收集设置并验证它们。向进程监管器返回一个明确的配置错误。捕获每个失败并使用猜测的默认值继续可能会掩盖损坏的部署。

验证后，保留一个包含转换值的配置对象。在每个请求中反复读取和解析环境值更难推理，并可能导致应用程序的不同部分使用不同的策略。

在您自己的应用程序中指定优先级

如果应用程序使用命令行参数、环境变量和 INI 文件，请定义哪个源获胜。一种可能的策略是显式提供的参数，然后是存在的环境设置，然后是文件选项，最后是记录的默认值。这是应用程序的选择，而不是由 configparser 强制执行的内置排序。

ConfigParser 可以读取文件并执行选项转换，但它不会自动合并操作系统环境或命令行参数。除非启动器或显式库已加载它，否则不要将 .env 文件描述为已加载。

报告设置名称而不泄露其秘密值

记录名称和验证类别，例如 DATABASE_URL is missing，而不包含连接字符串。令牌可能出现在 URL 内部，而不仅仅在名称包含 PASSWORD 的设置中。诊断启动问题时避免转储所有环境变量。

对于非秘密设置，请单独决定显示其值是否合适。解析器示例使用固定的错误消息使这种区分变得简单。

理解进程配置更改的含义

os.environ 表示当前进程环境，在导入 os 时捕获。更新它会更改此进程，并可能影响它启动的子进程；它不会重新配置已在运行的不相关进程。在更改其部署设置时，重新启动或显式重新配置相关服务。

操作系统行为各异，包括 Windows 上名称的大小写处理。字节环境接口仅在 os.supports_bytes_environ 允许的地方可用。除非记录的平台需求另有要求，否则对普通应用程序配置使用正常的字符串接口。