workspace/code/fms/.workbuddy-ai/memory/topics/env-and-baseline.md

本机环境坑 + 测试基线

环境坑（本机特有）

• 编译/测试 fms-api 唯一可行命令（start.cmd 里的 JDK/Maven 路径都是坏的）：

  cd /d/workspace/code/fms/fms-api && /d/devtool/jdk/jdk21/bin/java \
    -Dclassworlds.conf="D:/devtool/maven/bin/m2.conf" -Dmaven.home="D:/devtool/maven" \
    -Dmaven.multiModuleProjectDirectory="D:/workspace/code/fms/fms-api" \
    -cp "D:/devtool/maven/boot/plexus-classworlds-2.11.0.jar" \
    org.codehaus.plexus.classworlds.launcher.Launcher -o -Dtest=XxxTests test
  

  本地仓库是 D:\data\maven（不是 ~/.m2）；联网下载去掉 -o；target/ 被 git 跟踪，编译后有噪音。
• 无 sqlcmd/pyodbc/pymssql：用 fms-api/tools/migration/RunSqlFile.java 或一次性 SqlRunner.java
  • JDBC jar（~/.m2/.../mssql-jdbc-13.4.0.jre11.jar）+ /d/devtool/jdk/jdk17/bin/java。 脚本要按行首 GO 分批，路径传绝对路径。
• vite build 被 safe-delete 守卫拦（要删 600+ 文件）：用 --outDir dist-verify --emptyOutDir； 清理用 find dist-verify -type f -delete 再 find dist-verify -type d -empty -delete。
• oxfmt --check 全仓库都报 format issues（版本漂移），不是自己引入的，别顺手格式化整个仓库。
• 本工作区可能被多会话同时编辑，验证失败项先用 find <dir> -mmin -N 确认是否自己引入。

测试基线（既有失败，别去修）

• 后端 OrgDataSourceFactoryTests.databaseConnectionFailureDoesNotRetry（断言 Druid retry=0，实测 1）。
• 前端 tests/unit/fms-module-list-page.spec.js 里引用 .filter-drawer/.filter-row__* 的用例 （类名已不存在，是高级查询面板改版后的过期断言）—— 另有约 13 个长期失败基线。
• tests/helpers/app.js 的 mountPage 用 shallowMount 且默认打桩子组件：给 Splitter/SplitterPanel 打桩时键名要写 Vue 推断名 'splitter'/'panel'（文件名小写），写 'SplitterPanel' 打不上桩； 自定义组件传 false 可强制真实挂载。global 会整体覆盖内部 stubs，别在里面再写 stubs。