Skip to content

docs: 在 README 增加启动后端的两种环境变量加载方式#30

Open
F1sh2712 wants to merge 1 commit intoInvolutionHell:mainfrom
F1sh2712:docs/local-env-setup-guide
Open

docs: 在 README 增加启动后端的两种环境变量加载方式#30
F1sh2712 wants to merge 1 commit intoInvolutionHell:mainfrom
F1sh2712:docs/local-env-setup-guide

Conversation

@F1sh2712
Copy link
Copy Markdown

@F1sh2712 F1sh2712 commented May 8, 2026

What

在 README 的"启动后端服务"章节增加两种环境变量加载方式的说明。

Why

./mvnw spring-boot:run 不会自动读取 .env 文件,但 README 没有说明启动前如何加载环境变量。新贡献者按 README 走会因为 Java 进程拿不到 PGPASSWORD 等变量而启动失败:
The server requested SCRAM-based authentication, but no password was provided.

Closes #25

How

把"启动后端服务"章节从单一命令扩展为两种方式:

  • 方式 1:维护者团队内部使用的 set -a && . ./.env && set +a(macOS / Linux)
  • 方式 2:IntelliJ IDEA + EnvFile 插件

set -a 那一行附了一句简短解释,避免对该 shell 语法不熟的读者困惑。

Testing

实测两种方式都能成功启动后端:

  • 方式 1:在 命令行 里执行 set -a && . ./.env && set +a 后跑 ./mvnw spring-boot:runStarted BackendApplication
  • 方式 2:IDEA 配好 EnvFile 后点绿色三角 → Started BackendApplication

未启用任何方式直接跑 ./mvnw spring-boot:run 会复现 SCRAM 认证失败,验证 README 新说明的必要性。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

新贡献者本地启动后端时遇到的多个问题汇总

1 participant