Skip to content

[Bug][scripts] check-test-import-graph fails to parse any imports on Windows, always passes locally | [Bug][scripts] check-test-import-graph 在 Windows 上解析不出任何 import,本地恒通过 #6831

Open

Description

@BBleae

摘要

scripts/check-test-import-graph.mjs 在 Windows 上一条相对 import 都解析不出来,所以不可能报违规:恒输出 ok,退出码 0。

原因在 resolveSpec:它拿 path.relative(root, p) 的结果去 SRC_FILES 里找。SRC_FILES 来自 git ls-files,是正斜杠路径;path.relative 在 Windows 上给的是反斜杠路径,两边永远对不上。

对照的代码是 master 的 26d9bcc6(package.json 里的版本是 0.1.215)。CI 里这道闸只在 ubuntu 上跑(CI / test-import-graph),不受影响;受影响的是在 Windows 上本地跑它的人。

环境:Windows 11,Node 22。这是仓库里的开发脚本,和使用模式、客户端、上游无关。

现在的行为

function resolveSpec(fromFile, spec) {
    let p = path.resolve(root, path.dirname(fromFile), spec);
    if (!p.endsWith(".ts") && !p.endsWith(".js")) p += ".ts";
    if (p.endsWith(".js")) p = p.slice(0, -3) + ".ts";
    const rel = path.relative(root, p);
    return SRC_FILES.includes(rel) ? rel : null;
}
  • Windows 上 rel 是 src\server.ts 这样的路径,SRC_FILES 里是 src/server.ts,resolveSpec 恒回 null。
  • 从入口出发的 BFS 因此停在入口本身,reachable 等于入口文件数。
  • 检查测试文件的那一段,每个 import 都在 if (!target || …) continue; 被跳过,violations 恒为空。

在 Windows 上对 26d9bcc6 跑出来的输出:

production entries: 19; src modules: 320; reachable: 19

unreachable from the production import graph:
  …(除入口以外的 301 个 src 模块,src/server.ts、src/session.ts 都在里面)

ok: every test import of an unreachable module is whitelisted or labeled.

src/server.ts 被列为不可达,又被很多测试文件直接 import,都没有白名单或 retired-module pin 标记,脚本仍然报 ok。

影响

重现

在 Windows 上:

  1. 检出 master。
  2. node scripts/check-test-import-graph.mjs。
  3. 第一行的 reachable 等于 production entries(现在都是 19)。

建议的修法

在 resolveSpec 里把分隔符归一成正斜杠再比:

const rel = path.relative(root, p).split(path.sep).join("/");

scripts/test-suite-lock.mjs 和 scripts/check-dist-external.mjs 里已经是这个写法。

我在脚本的一份副本上试过这一行(同一棵树,Windows):第一行变成 reachable: 316(320 个模块里),不可达的剩 4 个,结果仍是 ok。ubuntu 上 path.sep 就是 /,这一行不改变那里的行为。

相关

Activity

  1. changed the title [-][Bug][scripts] check-test-import-graph 在 Windows 上解析不出任何 import,本地恒通过[/-] [+][Bug][scripts] check-test-import-graph fails to parse any imports on Windows, always passes locally | [Bug][scripts] check-test-import-graph 在 Windows 上解析不出任何 import,本地恒通过[/+] on Nov 15, 2026
  2. ranxianglei commented on Nov 15, 2026

    @ranxianglei
    Owner

    🤖 Powered by ework · qwen3.8-27b

    (ai: vllm-qwen/qwen3.8-27b)

    查重: 不重复。 open+closed 搜 check-test-import-graph 只命中本 issue 和若干仅在验证清单里提到该脚本的 PR;搜 windows backslash path 最接近的是 #1629(已关闭)——那是 tests/text-safe.test.ts family gate 的路径分隔符问题,症状相反(那道闸在 Windows 上会失败,这道在 Windows 上恒通过),文件与机制都不同。在途 PR 也核过:wave-11 批量 PR #6827 的 53 个文件不含 scripts/,没有平行修复。

    标签判定: bug / scope/ci / p3(开发脚本缺陷,只影响 Windows 本地跑这道闸的人,CI 与产品均不受影响)。按 2026-11-12 的源 issue 不可改标规则,标签不直接打到本 issue 上,由 owner 按需补;修复 PR 已按自身 diff 打了 bug + p3。

    修复 PR: #6838 (CI 刚触发,以 CI 结果为准)

    结构化八问

    1. 是什么问题:test-import-graph 闸在 Windows 上一条相对 import 都解析不出来,本地运行恒报 ok——Windows 上的「干净」不说明任何事,真正结论只在 CI 里。
    2. 什么原因导致的:resolveSpec 拿 path.relative(root, p) 的结果直接对 SRC_FILES 做 includes。SRC_FILES 来自 git ls-files,永远是正斜杠;Windows 上 path.relative 产出 src\server.ts 这样的反斜杠路径,两边永远对不上 → resolveSpec 恒回 null → 从入口出发的 BFS 停在入口本身 → 检查测试文件时每个 import 都在 if (!target || …) continue 被跳过 → violations 恒为空。与 issue 描述一致,已在本地用「重写 path.relative 输出为反斜杠」的仿真复现:未修脚本在带违规的 fixture 上 exit 0(闸失明),reachable 停在入口数。
    3. 影响范围与严重程度:只影响在 Windows 上本地跑这道闸的人;CI job(CI / test-import-graph)是 ubuntu-only,不受影响,CI 判定一直有效。严重度:本地验证能力在 Windows 上完全失效(假绿),属边缘场景工具问题,不是产品缺陷。
    4. 怎么修复的:resolveSpec 里在 SRC_FILES 查找前把反斜杠归一成正斜杠(一行)。兄弟脚本用 .split(path.sep).join("/"),但 path.sep 在 POSIX 上是 /,那个写法在 Linux 上是 no-op,POSIX CI 无法验证 Windows 形状——所以这里刻意用显式反斜杠形式 .split("\\").join("/")(Windows 上两者行为完全相同)。回归测试 tests/check-test-import-graph.test.ts 把真实脚本当子进程跑在一次性 git fixture 上,用 --import 预加载把 path.relative 输出改写成反斜杠来仿真 win32 形状,四个 case(native/win32 × 有违规/干净)双向断言:已验证未修脚本上两个 win32 case 红、修后四个全绿;对真实仓库跑闸结果不变(reachable: 316,exit 0)。
    5. 是否有回归问题:POSIX 上零行为变化(path.relative 在那里从不产出反斜杠);修后对仓库跑闸与修前输出一致;typecheck 绿。唯一行为变化是 Windows 本地运行从「恒通过」变为「真正评估」——见下条披露。
    6. 是否破坏缓存:不涉及(纯开发脚本,无缓存/重试/游标逻辑)。
    7. 是否改了设计方向:不涉及。
    8. 是否引入了新的配置:不涉及。

    行为变更披露(旧→新):旧——Windows 本地运行恒 ok(假绿);新——Windows 本地运行真正解析 import,可能出现以前不会出现的失败。POSIX 与 CI 无变化。原因:这正是修复目的,一道恒绿的闸等于没有闸。

    另外确认 issue 里提到的连带影响:你在 #6353 描述、139010f3 评论及另几个 PR 描述、一个 kernel 授权申请 issue 里把这道闸的本地结果列为验证项——那些在 Windows 上跑的结果确实不算证据,以各 PR 的 CI 结果为准,无需回改那些文字(CI 判定本就有效)。

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

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions