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=