PyTorch 1.x模型加载到2.x报RuntimeError: version错误，主因是跨大版本序列化格式不兼容，需统一PyTorch版本、使用map_location指定设备、优先加载state_dict并验证文件完整性。
PyTorch 1.x 模型加载到 2.x 报 RuntimeError: version_
这是最典型的信号：你用 PyTorch 2.x 加载了在 1.x（尤其是 ≤1.12）保存的 torch.save() 文件。PyTorch 2.0 起默认启用了新序列化格式（zip 格式 + 新版元数据），而旧模型是 pickle + 旧版二进制结构，直接 torch.load() 会触发版本校验失败。
根本原因不是模型结构不兼容，而是保存格式的底层变更。解决思路不是重训，而是“降级加载”或“格式转换”：
- 临时切回 PyTorch 1.x 环境（如 1.13）加载模型，再用 2.x 的
torch.save()重新保存一次（推荐用于调试，不适用于生产环境） - 在 PyTorch 2.x 中强制启用旧格式兼容模式：
torch.load(..., weights_only=False, map_location='cpu')—— 注意必须显式设weights_only=False（2.x 默认为True，会拒绝加载含代码/类定义的旧文件） - 若模型保存时用了
model.state_dict()（而非整个模型对象），通常可直接加载；但若保存的是torch.save(model, ...)，则大概率含模块类引用，需依赖兼容模式
模型结构在 1.x 和 2.x 间实际是否需要修改
绝大多数情况下不需要改模型代码。PyTorch 2.x 保持了对 nn.Module 接口、层行为、autograd 语义的完全向后兼容。但有三个关键例外点必须检查：
-
torch.jit.script()或torch.jit.trace()导出的模型：1.x 的 TorchScript 字节码无法被 2.x 直接加载，需用原 1.x 环境重新导出，或改用torch.export.export()（2.0+ 新 API） - 自定义
torch.nn.Module中使用了已弃用方法，例如forward(self, input)里手动调用input.data（2.x 中.data已被标记为不安全，应改用.detach()） - 使用了
torch._C._set_cudnn_enabled(False)等内部 C++ API：这些在 2.x 中已被移除或重构，需替换为公开接口（如torch.backends.cudnn.enabled = False）
从 PyTorch 1.x 迁移训练脚本到 2.x 的最小改动清单
不是所有 1.x 写法在 2.x 都报错，但部分惯用写法在 2.x 下效率下降或行为隐晦变化。以下改动能避免多数静默问题：
立即学习“Python免费学习笔记（深入）”；
- 把
model.train(); model(input)替换为model.train(); model(input).mean().backward()—— 2.x 对无梯度计算图的清理更严格，裸调用model(input)后不 backward 可能导致缓存膨胀 - 禁用
torch.backends.cudnn.benchmark = True（尤其在 batch size 动态变化时）：2.x 的 cuDNN autotuner 在某些场景下会反复编译 kernel，引发显存抖动 - 检查
torch.optim.lr_scheduler初始化：1.x 允许传入空optimizer.param_groups后再 add_param_group，2.x 要求初始化时至少有一个 group，否则报ValueError: optimizer has no param groups - 若用
F.interpolate()，显式指定align_corners=True/False：2.x 中默认值从None改为False，省略参数会导致插值结果偏移
验证迁移后模型行为一致性的实操建议
光能加载不等于等价。重点验证三类输出一致性：
- 前向输出：用固定 seed + 固定输入，对比 1.x 和 2.x 的
model(input).detach().cpu().numpy()，允许浮点误差1e-5（注意确保都关 cudnn deterministic） - 梯度输出：对同一 loss，用
torch.autograd.grad(loss, model.parameters(), retain_graph=True)提取各层梯度，逐参数比对torch.allclose(grad1, grad2, atol=1e-5) - 状态字典 key 顺序：2.x 中
state_dict()的 key 顺序可能与 1.x 不同（因 Python dict 有序性保证增强），但值必须一一对应；不要依赖 key 的索引位置做逻辑
最容易被忽略的是 torch.compile() 的副作用——它会改变模型的执行路径和数值稳定性。迁移初期务必先关掉 torch.compile(model)，确认原始行为一致后再开启。
