发布时间： 2026-06-06 18:30:00

🕒 阅读时间：5 分钟 📝 字数：1759 👀 阅读量： Loading...

一个好几个月前在 QQ 里发现的 Bug

大概几个月前，我在 QQ 上把自己的博客链接分享给朋友。朋友点开后说”你这个网站背景怎么全是白的？“我当时还以为他在开玩笑——我精心挑的 42 张 SVG 图案当背景，怎么可能是白的？

结果我自己在 QQ 里点开链接——确实全白了。QQ 内置浏览器（X5 内核 WebView）把整站的 SVG 背景图案全部渲染成了白色，图案的黑色线条像是被人用漂白剂洗过一样。

我的第一反应不是怀疑自己的代码。我用手机上的 Firefox 打开 ——正常。Edge ——正常。就连 Chrome 也是好的。唯独在 QQ 内置浏览器和夸克这种第三方 App 里渲染出来是白的。

这就很明确了——不是我的 CSS 写错了，是这些 App 内置的魔改内核搞的鬼。如果是标准 Chromium 的 Bug，Chrome 原版也应该复现。

不过当时手头有别的事，这个问题就被搁置了。一直到今天才想起来，不过这次我换了种思路——不是自己闷头调试，而是让 AI 帮我把魔改内核的具体技术细节搜出来，然后根据搜到的信息来修复。

本文中关于魔改内核的反色层级、Chromium 的 force-dark 源码实现等技术细节，均来自 AI 搜索结果。我只是把问题的发现过程和排查思路用自己的话整理出来。

为什么一定是魔改内核的锅

AI 帮我搜到的信息印证了几个月前我的直觉判断。国内主流移动浏览器的内核全是基于 Chromium 或 WebKit 的魔改版本，它们在标准内核之上加了自己的”强制暗色模式”：

这解释了为什么手机上的 Firefox / Edge / Chrome 原版都正常——它们走的是标准渲染管线，没有被注入额外的强制暗色逻辑。

魔改内核的三个”反色层级”

通过 AI 搜索 Chromium 源码和 StackOverflow 上的相关讨论，我发现魔改内核实现强制暗色模式时会按”激进程度”分三个层级：

问题出在第 3 层。AI 搜到的 Chromium issue tracker 讨论指出，当魔改内核在合成器层对整个页面做 invert() 时：

因为 SVG 通过 background-image 加载时，它在渲染管线中的身份是”背景图层”而非”图片元素”。魔改内核的反色逻辑在遍历渲染树时找不到这个 SVG——它已经变成了一个离屏渲染的位图层。

结果就是：stroke="#000"（黑色线条）→ invert() → #fff（白色线条）——图案彻底”洗白”。

AI 给出的修复方案：两层防御

知道了魔改内核的作案手法后，修复思路就很清晰了：在反色管线接触到 SVG 之前，声明”此元素不需要颜色调整”。

以下修复方案由 AI 根据搜索到的技术资料整理生成，我直接应用到实际项目中验证。

第一层：CSS 承载元素

在 background-image 的宿主元素上声明 color-scheme: only light：

.bg-layer {
    position: fixed;
    inset: 0;
    z-index: -10;
    background-repeat: repeat;
    background-size: auto;
    background-position: center;
    background-color: var(--stalux-bg-color, transparent);
    filter: var(--stalux-bg-filter, none);
    pointer-events: none;
    opacity: 0;
    /* 只对 Windows 高对比度模式有效，对魔改内核无效 */
    forced-color-adjust: none;
    /* 告诉所有浏览器：此元素禁止任何颜色方案调整 */
    color-scheme: only light;
}

View Transitions API 的过渡伪元素也要覆盖：

::view-transition-old(stalux-bg),
::view-transition-new(stalux-bg) {
    position: fixed;
    inset: 0;
    z-index: -10;
    background-repeat: repeat;
    background-size: auto;
    background-position: center;
    background-color: var(--stalux-bg-color, transparent);
    filter: var(--stalux-bg-filter, none);
    pointer-events: none;
    color-scheme: only light;
    forced-color-adjust: none;
}

为什么用 only light 而不是 light？ 根据 AI 搜到的 CSS Color Level 5 规范，only 关键字表示”强制此元素只使用指定的色彩方案，禁止浏览器做任何自动色彩调整”。如果没有 only，魔改内核仍可能在合成器阶段覆盖这个声明。

第二层：SVG 文件内部

这是最容易被跳过但最关键的一步。CSS 的 color-scheme 只能保护当前元素的渲染上下文，但 background-image: url(...) 加载的 SVG 是一个独立的渲染上下文——它在浏览器内部被解析为一个独立的 SVG Document，光栅化为位图后再贴到背景上。宿主元素的 color-scheme 声明无法穿透到这个独立上下文内部。

必须在 SVG 自身的 <style> 块中声明：

<svg version="1.1" xmlns="http://www.w3.org/2000/svg"
     viewBox="0 0 1125 2436" xml:space="preserve">
<style>
    :root{color-scheme:only light}
    .prefix__st0,.prefix__st1{fill:none;stroke:#000;stroke-width:3.3;...}
</style>
...
</svg>

批量处理全部 42 个文件：

cd src/assets/background
for f in pattern-*.min.svg; do
    sed -i 's|<style>|<style>:root{color-scheme:only light}|' "$f"
done

为什么两层缺一不可

flowchart TB
    subgraph compositor["魔改内核 Compositor 反色管线"]
        direction TB
        subgraph layer1[".bg-layer 渲染层"]
            direction TB
            shield1["color-scheme: only light
第一层：阻止合成器对该层反色"]
            subgraph layer2["SVG 内部渲染上下文（独立 Document）"]
                direction TB
                shield2[":root { color-scheme: only light }
第二层：阻止光栅化时的颜色映射"]
                result["stroke='#000' 保持黑色"]
            end
        end
    end
    shield1 --> shield2 --> result

构建流程注意事项

如果你的构建工具（SVGO/imagemin/Vite 的 SVG 插件）在构建时会重新处理 SVG，它可能会把注入的 :root{color-scheme:only light} 当作”无效规则”删掉。本项目用 Astro + Vite，SVG 通过 import.meta.glob 直接导入，Vite 不二次处理内容，所以注入的规则能完整保留。

如果你用了会重编码 SVG 的插件（如 gatsby-plugin-image、@sveltejs/enhanced-img），建议构建后验证：

grep -l "color-scheme" dist/_astro/pattern-*.svg | wc -l
# 应输出与源文件数量一致

同类问题的排查思路

如果你的项目也遇到”某某浏览器下 SVG 颜色不对”的问题，可以按这个顺序排查：

总结

这个问题的排查过程其实很简单——好几个月前在 QQ 上分享博客链接，通过 QQ 内置浏览器打开时发现 SVG 图案全白，而手机上的 Firefox/Edge/Chrome 原版都正常，我就知道不是自己的代码问题，而是这些 App 内置的魔改内核在作祟。真正花时间的不是调试，而是搞清楚魔改内核到底在哪个渲染阶段、用什么方式篡改了 SVG 的颜色——这部分全靠 AI 搜索 Chromium 源码和社区讨论才补全。