From 3ec11f321d0d5c0d6925cb81178dc2b28b8a7f1f Mon Sep 17 00:00:00 2001
From: yeg <1347747024@qq.com>
Date: 星期四, 17 九月 2026 13:27:20 +0800
Subject: [PATCH] docs(agents): 测试命令写明用 pwsh 跑

---
 docs/agents/testing.md |    4 ++++
 1 files changed, 4 insertions(+), 0 deletions(-)

diff --git a/docs/agents/testing.md b/docs/agents/testing.md
index 59445d4..baf9fb9 100644
--- a/docs/agents/testing.md
+++ b/docs/agents/testing.md
@@ -34,6 +34,10 @@
 脚本会设置 `TEST_DATASOURCE_*`（MySQL `127.0.0.1:8134`、`talent_card_test`、`root/123456`，
 也可用环境变量覆盖），把日志写到 `target/server-tests.log`，并在失败时列出已知基线失败。
 
+**用 `pwsh` 跑**（本机装了 PowerShell 7：`C:\Program Files\PowerShell\7\pwsh.exe`）。脚本也已在
+Windows PowerShell 5.1 下实测通过——但如果 5.1 里出现"构建在编译中途莫名中断"，先换 `pwsh` 再怀疑代码：
+5.1 会把 Maven 打到 stderr 的警告（例如 JVM 的 `sun.misc.Unsafe`）当成终止错误。
+
 **必须走这个脚本（或等价地只跑一个 Maven 进程）。** 同一个 checkout 上并发跑两个构建会写坏
 `target/`，症状是看起来不可能的报错——例如 `No qualifying bean of type 'HuifuPaymentProperties'`。
 遇到这类"不可能"的 bean/classpath 错误，先 `-Clean`，再怀疑代码。

--
Gitblit v1.7.1