CONFIGURATION PARAMETER连接和认证 / 认证

password_expiration_warning_threshold

当此参数大于零时，如果距离已认证角色的密码过期剩余时间少于这个时长，服务器会在成功完成密码认证后发出 WARNING。

Threshold for password expiration warnings.

整数引入 19 现存至 20 devel 0 次默认值变更开发版

类型: 整数integer
分类: 连接和认证 / 认证
引入版本: 19
状态: 现存

PostgreSQL 20 devel 手册官方文档引入提交 1d92e0c2cc

版本轨迹

相对 PostgreSQL 19 无变化。 20 开发版尚未定稿：类型与说明取自手册，默认值、上下文和运行值尚未采样。

默认值变迁

7 d 19

仅记录了 PostgreSQL 19 的默认值。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。

手册说明

PostgreSQL 20 devel 手册 · 19.3 连接和认证本站手册官方原文

当此参数大于零时，如果距离已认证角色的密码过期剩余时间少于这个时长，服务器会在成功完成密码认证后发出 WARNING。注意只有在 CREATE ROLE 或 ALTER ROLE 的 VALID UNTIL 子句中指定了日期时，角色密码才会过期。如果不带单位指定此值，则按秒计。默认值为 7 天。此参数只能在 postgresql.conf 文件中或者服务器命令行上设置。

机制详解

password_expiration_warning_threshold：设置密码到期告警的提前时间阈值。重新加载配置即可让服务器采用新值，无需完整重启。本站在 PG19 Beta 3 实测到它；boot_val 是编译或初始化基线，并不能证明某个运行集群的当前有效值。

密码认证成功后，如果带 VALID UNTIL 的角色剩余有效期小于该区间，PostgreSQL 会发出警告。0 禁用告警；默认七天窗口只负责提醒，不会创建、轮换或延长凭据，使用非密码认证也不会让密码生命周期自动化。

应与 password_encryption、authentication_timeout、md5_password_warnings、hba_file 一起理解。请在目标服务器检查 SHOW 与 pg_settings，确认 source 和 pending_restart，并在修改前后对比真实负载、日志和资源指标。

调优建议

按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。

OLTP在线事务处理

通过分批客户端上线，验证证书选择与到期告警，并监控认证失败。保留测试过的回退方案，把文件权限和密钥轮换作为同一变更的一部分。
OLAP分析与批处理

批处理驱动与长连接 ETL 也应采用同一安全策略；测试不发送 SNI 的客户端、凭据到期自动化、reload 行为和证书链兼容性。
小规格低配实例与开发机

优先保持简单且有文档的 TLS 与凭据策略。没有覆盖每个主机名和回退路径的测试就不要启用多证书路由，更不能降低验证强度来掩盖配置错误。

常见问题

把 password_expiration_warning_threshold 的实测 boot_val 当成初始化后或托管集群当前有效值的证明。
忽略 pg_settings 报告的 sighup context，误以为修改会立即生效。
孤立修改该参数，没有检查关联上限、可观测性和回滚路径。
在生产中依赖测试版行为，却没有在 PostgreSQL 19 正式版发布后重新验证。

演化历史

相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。

PostgreSQL 19 ← 18 新增此参数

PostgreSQL 19 起可用

逐版本快照

每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。

版本	默认值	单位	上下文	类型	最小值	最大值	枚举值
19	`7 d`	`s`	`重载生效`	`整数`	`0`	`2147483647`	`—`
20	—	—	—	`整数`	—	—	—

参考资料

同类参数

参数	类型	上下文	默认值	最近变更
Connections and Authentication 连接和认证 10 个 ↗
认证 10
`authentication_timeout`	整数	重载生效	`1 min`	—
允许完成客户端认证的最长时间。				现存
`db_user_namespace`	布尔	重载生效	`off`	—
此参数启用各数据库独立的用户名。				于 17 移除
`gss_accept_delegation`	布尔	重载生效	`off`	—
设置是否接受客户端的 GSSAPI 委派。				现存
`krb_caseins_users`	布尔	重载生效	`off`	—
设置是否应该以大小写不敏感的方式对待 GSSAPI 用户名。				现存
`krb_server_keyfile`	字符串	重载生效	`FILE:/etc/postgresql-common/krb5.keytab`	9.11 次
设置服务器的 Kerberos 密钥文件的位置。				现存
`md5_password_warnings`	布尔	会话	`on`	—
控制在使用 MD5 加密密码成功认证时，或者在 CREATE ROLE 或 ALTER ROLE 语句设置 MD5 加密密码时，是否生成有关 MD5 密码已弃用的 WARNING。				现存
`oauth_validator_libraries`	字符串	重载生效	`空字符串`	—
设置用于验证 OAuth 连接令牌的库。				现存
`password_encryption`	枚举	会话	`scram-sha-256`	142 次
当在 CREATE ROLE 或 ALTER ROLE 中指定密码时，该参数决定用于加密密码的算法。				现存
`password_expiration_warning_threshold`	整数		—	—
当此参数大于零时，如果距离已认证角色的密码过期剩余时间少于这个时长，服务器会在成功完成密码认证后发出 WARNING。				现存
`scram_iterations`	整数	会话	`4096`	—
使用 SCRAM-SHA-256 加密密码时执行的计算迭代次数。				现存

快速链接