预热最危险的时刻，往往是读者已经开始访问“新版本”，加载器却只填了一半数组。文件没读完、维度不一致或遇到NaN，既可能让查询失败，也可能悄悄改变距离排序。

把预热包当数据制品发布，比把它当一个大循环更容易审查：完整读取并校验，构建不可变快照，最后只切换一个引用。构建失败，读者继续看到旧快照。

文件层与内存层分别验

文件头应有格式版本、Embedding模型身份、维度、条数、载荷长度和摘要。读入前限制最大字节数，读入后核实际长度与摘要，拒绝截断和多余内容。摘要能发现意外损坏，但如果来源不可信，还需要真实性校验，不能把SHA-256当授权。

内存层再检查ID重复、向量长度、有限数值及业务版本。Spring AI 2.1 M1公告介绍预计算Embedding写入能力，发布日期为9月25日；它没有替自定义二进制预热包完成这些校验。公告。

运行一个原子发布的最小例子

这里只验证内存快照，不读取磁盘，不接向量引擎。向量被复制后装入快照，读端一次取得整个对象，不能分别读取版本号与数组两个易混用的字段。

import java.util.ArrayList; import java.util.Collections; import java.util.List; import java.util.concurrent.atomic.AtomicReference; public class WarmupSnapshot { static class Snapshot { final String model; private final List<double[]> vectors; Snapshot(String model, List<double[]> vectors) { this.model = model; this.vectors = Collections.unmodifiableList(vectors); } double value(int row, int col) { return vectors.get(row)[col]; } } static Snapshot build(String expected, String model, List<double[]> input) { if (!expected.equals(model) || input.size() > 100) throw new IllegalArgumentException("identity or size"); List<double[]> copy = new ArrayList<>(); for (double[] v : input) { if (v == null || v.length != 2) throw new IllegalArgumentException("dim"); for (double x : v) if (!Double.isFinite(x)) throw new IllegalArgumentException("non-finite"); copy.add(v.clone()); } return new Snapshot(model, copy); } public static void main(String[] args) { double[] source = {1, 0}; AtomicReference<Snapshot> current = new AtomicReference<>( build("m1", "m1", List.of(source))); source[0] = 99; assert current.get().value(0, 0) == 1; Snapshot old = current.get(); try { Snapshot next = build("m1", "m1", List.of(new double[]{Double.NaN, 0})); current.set(next); throw new AssertionError("invalid vector accepted"); } catch (IllegalArgumentException expected) { } assert current.get() == old; current.set(build("m2", "m2", List.of(new double[]{0, 1}))); Snapshot seen = current.get(); assert seen.model.equals("m2") && seen.value(0, 1) == 1; System.out.println("snapshot: copy, reject, atomic replacement checked"); } }

保存为WarmupSnapshot.java，执行javac --release 11 WarmupSnapshot.java && java -ea WarmupSnapshot。维度2、上限100都是教学值；真实上限应来自制品合同和容量预算。本例没有证明文件读取器安全，也没测加载耗时或堆占用。

切换成功还不等于答案正确

新快照加载完整，仍可能来自错误Embedding模型或过期业务规则。发布前用一组明确的查询与期望候选检查语义，不只看条数。旧快照应保留到核验结束，回退切换也要有可追溯的制品ID。

请求已经持有旧快照时，让它在原快照上完成通常比中途混入新数据更容易解释。后续若做并发验证，要让多个读者在反复切换时断言“版本与所有行来自同一代”，再观察加载期间内存峰值。原子引用只管发布边界，不承诺预热收益。

本地验证记录：Oracle JDK 12.0.1，javac --release 11与java -ea，运行成功，输出snapshot: copy, reject, atomic replacement checked。仅覆盖本例的离线输入；框架、供应商和生产集成仍未测试。