GitLab CI并行执行Nx指定测试文件失败，求解决方案

问题场景 #

项目包含数千个*.spec.ts(x)测试文件，需在GitLab CI中利用parallel作业实现测试文件的动态拆分执行。但使用nx test命令传递--testFile或--grep参数时，命令始终运行全部测试，完全忽略传入的指定文件路径。项目基于Nx 16.10.0单体仓库，底层测试框架为Jest。

有效解决方案 #

1. 传递Jest原生参数（需用--分隔） #

Nx的nx test命令中，需要用--分隔Nx自身参数与Jest原生参数，否则Nx不会将参数透传给Jest。针对指定测试文件，推荐两种Jest原生参数：

方式一：使用--testPathPattern（正则匹配文件路径）

通过正则表达式匹配需要运行的测试文件，适合批量匹配：

nx test my-project -- --testPathPattern="apps/my-project/file1.spec.ts|apps/my-project/file2.spec.ts"

若路径包含特殊字符（如.、/），需进行正则转义。

方式二：使用--findRelatedTests（直接指定文件列表）

直接传入多个测试文件路径，无需正则，更直观：

nx test my-project -- --findRelatedTests apps/my-project/file1.spec.ts apps/my-project/file2.spec.ts

2. 排查参数无效原因 #

• --testFile并非Nx或Jest的标准参数，Nx 16.x版本不会识别该参数，因此无法生效。
• --grep参数用于匹配测试用例名称，而非测试文件路径，除非测试用例名称中包含完整文件路径，否则无法通过该参数筛选文件。

GitLab CI并行作业落地示例 #

在GitLab CI配置中，结合CI_NODE_TOTAL（总并行节点数）和CI_NODE_INDEX（当前节点索引）实现动态拆分：

test:
  parallel: 4  # 根据需求调整并行节点数
  script:
    # 1. 收集所有目标测试文件
    - find apps/my-project -name "*.spec.ts" -o -name "*.spec.tsx" > all_tests.txt
    # 2. 拆分文件为对应节点的分组
    - split -n l/$CI_NODE_TOTAL/$CI_NODE_INDEX all_tests.txt current_node_tests.txt
    # 3. 读取当前节点的测试文件列表并执行
    - TEST_FILES=$(cat current_node_tests.txt | tr '\n' ' ')
    - nx test my-project -- --findRelatedTests $TEST_FILES

额外检查项 #

• 查看项目的project.json或nx.json中，test目标的options字段是否存在硬编码的testPathPattern等配置，若有会覆盖传入的参数，需移除或调整。
• 可通过nx test my-project -- --showConfig命令查看最终生效的Jest配置，确认传入的参数是否被正确应用。

内容的提问来源于stack exchange，提问作者Nickon