docs(backend): 同步 worker 数注释(生产 4 -> 2,与 2 核匹配)
仅注释变更,**无行为变更**。EGG_WORKERS 实际由 deploy/.env.production 注入 +
deploy/start-backend.sh 兜底决定,本次把注释里写死的旧口径同步为 2,避免
「注释与配置漂移」再次误导后人。
- app.js:
· 「生产显式设为 4」-> 2
· 「4×20=80(安全)」->「2×20=40(安全)」
· 「本地 dev 也会加载 .env.production,其中写着 4」-> 2
· 「dev 下真 worker=1 却报 4×20=80」-> 2×20=40
- config/config.default.js:
· 「生产值写在 deploy/.env.production(EGG_WORKERS=4)」-> 2(并注明 2026-09-29
R40 由 4 校正为 2)
· 「4 × 20 = 80」->「2 × 20 = 40」
· pool 段「worker 数由 EGG_WORKERS 显式控制(生产 = 4)」-> 2
· 「本机/多数服务器为 8 核 → 8 个 worker」->「核数越多起得越多(开发机 8 核 → 8 个)」
(原文把"8 核"当成多数服务器的事实,与实测的 2 核服务器不符)
背景(R40 · BACKLOG C2):worker 数 ≈ CPU 核数。worker 数 > 核数对 CPU 型路径
(bcrypt 登录)**零收益** —— 加 worker 不加核(native bcrypt 走 libuv threadpool),
只增加 context switch 与内存(单 worker 空闲 RSS ≈108MB)。登录容量由物理核数
决定(实测 ≈12.6 次/核·秒)⇒ 2 与 4 的登录容量相同。连接池 2×20=40 ≤ 151-20 ✅
验证:node --check app.js / config/config.default.js 通过;
verify-c1c2.py 含「五处文档/代码注释已无旧口径「4」残留」断言(24/24 通过)。
This commit is contained in:
8
app.js
8
app.js
@@ -67,8 +67,8 @@ class AppBootHook {
|
||||
//
|
||||
// 🔴 2026-09-21 修正(并发压测结论):原实现用 `os.cpus().length` 估 worker 数,
|
||||
// 这是**误估** —— 真实 worker 数由 egg-scripts 的 --workers / EGG_WORKERS 决定
|
||||
// (生产显式设为 4,见 config.default.js「集群 worker 数」段),与 CPU 核数无必然关系。
|
||||
// 误估会在 8 核机上把「4×20=80(安全)」误报成「8×20=160(越限)」,
|
||||
// (生产显式设为 2,见 config.default.js「集群 worker 数」段),与 CPU 核数无必然关系。
|
||||
// 误估会在 8 核机上把「2×20=40(安全)」误报成「8×20=160(越限)」,
|
||||
// 既制造假告警、也会掩盖真实的越限,使这条断言失去作用。
|
||||
// 改为优先读 EGG_WORKERS(worker 进程继承 master 的环境变量),回退才用 CPU 数,
|
||||
// 并在日志中显式标注估算依据,便于排障时判断该行可信度。
|
||||
@@ -81,10 +81,10 @@ class AppBootHook {
|
||||
const usingExplicit = Number.isFinite(explicitWorkers) && explicitWorkers > 0;
|
||||
// 🔴 2026-09-21 二次修正:egg-bin dev / test 会**显式传** `workers: 1`
|
||||
// (node_modules/egg-bin/scripts/start-cluster.js),此时即便环境里存在
|
||||
// EGG_WORKERS(本地 dev 也会加载 deploy/.env.production,其中写着 4),
|
||||
// EGG_WORKERS(本地 dev 也会加载 deploy/.env.production,其中写着 2),
|
||||
// 也不是真实 worker 数 —— 真实值是 1。故必须先按 app.config.env 判定
|
||||
// 单 worker 的运行形态,否则本地仍会打出一条假数字日志(实测:dev 下
|
||||
// 真 worker=1 却报 4×20=80)。
|
||||
// 真 worker=1 却报 2×20=40)。
|
||||
const envName = (this.app.config && this.app.config.env) || '';
|
||||
const singleWorkerEnv = envName === 'local' || envName === 'unittest';
|
||||
let workers;
|
||||
|
||||
Reference in New Issue
Block a user