docs(backend): 补充生产 .env 模板说明(SMTP 必填、LF 行尾、端口来源)
- 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 时加载,生产不生效)
This commit is contained in:
parent
640f39ed2e
commit
5908cacdf5
@ -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=
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user