diff --git a/.env.server.example b/.env.server.example index 2fdb8c00..719dbde2 100644 --- a/.env.server.example +++ b/.env.server.example @@ -49,6 +49,8 @@ POSTGRES_MAX_PARALLEL_WORKERS_PER_GATHER=1 # 检查点频率与 WAL 上限:放宽后写突发从「5 分钟一轮」变成「15 分钟一轮」 POSTGRES_CHECKPOINT_TIMEOUT=900 POSTGRES_MAX_WAL_SIZE=4GB +# 超过该毫秒数的自动清理会打日志(600000=只有 >10 分钟的才记,等于看不到) +POSTGRES_LOG_AUTOVACUUM_MIN_DURATION_MS=5000 # 后端与 Web 容器限额(内存紧张的小机器可相应收紧) BACKEND_MEM_LIMIT=768m BACKEND_CPUS=1.5 diff --git a/apps/backend/src/config/env-documentation.test.ts b/apps/backend/src/config/env-documentation.test.ts index 3f6a02ff..65a8dd84 100644 --- a/apps/backend/src/config/env-documentation.test.ts +++ b/apps/backend/src/config/env-documentation.test.ts @@ -36,6 +36,7 @@ const DEPLOYMENT_ONLY_ENV_NAMES = [ 'POSTGRES_MAX_PARALLEL_WORKERS_PER_GATHER', 'POSTGRES_CHECKPOINT_TIMEOUT', 'POSTGRES_MAX_WAL_SIZE', + 'POSTGRES_LOG_AUTOVACUUM_MIN_DURATION_MS', 'BACKEND_MEM_LIMIT', 'BACKEND_CPUS', 'BACKEND_NODE_OPTIONS', diff --git a/apps/backend/src/db/migrations/092_hot_table_autovacuum_tuning.sql b/apps/backend/src/db/migrations/092_hot_table_autovacuum_tuning.sql index 1c62ab2a..a68a3195 100644 --- a/apps/backend/src/db/migrations/092_hot_table_autovacuum_tuning.sql +++ b/apps/backend/src/db/migrations/092_hot_table_autovacuum_tuning.sql @@ -56,7 +56,9 @@ ALTER TABLE fulfillment_tasks SET ( autovacuum_vacuum_cost_limit = 800 ); --- 打开 autovacuum 观测(原先 log_autovacuum_min_duration = 600000, --- 只有超过 10 分钟的 vacuum 才会留日志,等于什么都看不到)。 --- 这里改成表级不可设,只能改库级:记录超过 5 秒的自动清理,便于事后核对清理节奏。 -ALTER DATABASE order_site SET log_autovacuum_min_duration = 5000; +-- 注意:观测用的 log_autovacuum_min_duration **不在这里设置**。 +-- 它是 sighup 级参数,`ALTER DATABASE ... SET` 会直接报 +-- `55P02 parameter "log_autovacuum_min_duration" cannot be changed now` +-- (2026-10-03 首次部署时正是这么失败的,整条迁移回滚)。 +-- 它只能通过 postgres 启动参数给出,见 docker-compose.yml 的 +-- `-c log_autovacuum_min_duration=${POSTGRES_LOG_AUTOVACUUM_MIN_DURATION_MS:-5000}`。 diff --git a/docker-compose.yml b/docker-compose.yml index e4fd0375..3cf50b9c 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -38,6 +38,10 @@ services: "checkpoint_timeout=${POSTGRES_CHECKPOINT_TIMEOUT:-900}", "-c", "max_wal_size=${POSTGRES_MAX_WAL_SIZE:-4GB}", + # 自动清理观测:默认 600000(10 分钟)等于什么都看不到。 + # 这是 sighup 级参数,不能 ALTER DATABASE SET,只能走启动参数。 + "-c", + "log_autovacuum_min_duration=${POSTGRES_LOG_AUTOVACUUM_MIN_DURATION_MS:-5000}", ] restart: unless-stopped # 让 PostgreSQL 优雅关闭有足够时间完成检查点;无限制时 OOM 可能拖垮整机。