From 5908cacdf5425a777193ae663247b8eb58100212 Mon Sep 17 00:00:00 2001 From: liufumingren Date: Mon, 14 Sep 2026 22:20:02 +0800 Subject: [PATCH] =?UTF-8?q?docs(backend):=20=E8=A1=A5=E5=85=85=E7=94=9F?= =?UTF-8?q?=E4=BA=A7=20.env=20=E6=A8=A1=E6=9D=BF=E8=AF=B4=E6=98=8E?= =?UTF-8?q?=EF=BC=88SMTP=20=E5=BF=85=E5=A1=AB=E3=80=81LF=20=E8=A1=8C?= =?UTF-8?q?=E5=B0=BE=E3=80=81=E7=AB=AF=E5=8F=A3=E6=9D=A5=E6=BA=90=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - SMTP 段标注为生产必填,并说明未配置时 sendCode 走「仅记录日志」分支: 邮件不会发出,但 email_logs 仍写 status=1,排查时不要只看这张表 - 补充行尾警告:本文件必须为 LF,CRLF 会让 dotenv 把 \r 带进值里, 典型症状是 getaddrinfo ENOTFOUND smtp.qq.com(主机名尾部多了 \r) - 修正端口说明:EGG_PORT 由 config.default.js 的 config.cluster 读取 (config.local.js 只在 env=local 时加载,生产不生效) --- backend/env.production.example | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/backend/env.production.example b/backend/env.production.example index 0466bf4..e5a3726 100644 --- a/backend/env.production.example +++ b/backend/env.production.example @@ -41,13 +41,17 @@ OMS_CALLBACK_BASE_URL=http://api.oms.gztbyc.com # —— 实例监听端口(双实例发布必填且两套必须不同)—— # v1 → 6090、v2 → 6091,需与 backend/config/deploy.config.local.cjs 的 ports 一致。 -# 注意:Egg 端口取 config/config.local.js 的 EGG_PORT(默认 6090), -# 两套实例都用默认值会抢同一端口(EADDRINUSE,表现为健康检查一直不通过)。 -# 若使用「发布脚本传入 EGG_PORT」的方式,本项可省略;手工 npm start 启动时必须写对。 +# 注意:端口由 config/config.default.js 的 config.cluster 读取本变量(默认 6090)。 +# (不要写在 config.local.js 里:egg 只在 env=local 时加载该文件,生产不生效) +# 两套实例用同一端口会抢端口(EADDRINUSE),表现为发布健康检查一直不通过。 EGG_PORT=6090 -# —— 邮件(可选;不配置时邮箱验证码只输出到日志)—— -# SMTP_HOST= +# —— 邮件(生产必填;不配置 SMTP_HOST 时验证码只写日志、前端收不到)—— +# ⚠️ 未配置时 sendCode 会走「仅记录日志」分支:邮件不发出, +# 但 email_logs 仍写 status=1(成功),排查时别只看这张表 +# ⚠️ 本文件必须是 LF 行尾:用 CRLF 写入会让 dotenv 把 \r 带进值里, +# 典型症状是 getaddrinfo ENOTFOUND smtp.qq.com(主机名尾部多了个 \r) +# SMTP_HOST=smtp.qq.com # SMTP_PORT=465 # SMTP_SECURE=true # SMTP_USER=