PyTorch转ONNX报错“Unsupported ONNX opset version”是因为指定的opset_version超出当前PyTorch支持上限，应先运行torch.onnx.supported_opset_version确认最大版本再设置；动态控制流报错源于tracing机制无法捕获运行时分支，需改用torch.where、展开循环或升级至torch.export；ONNX Runtime报“Node input ‘xxx’ does not exist”多因自定义算子、副作用操作或dynamic_axes声明与实际输入名不一致，须用onnx.checker和Netron排查；dynamic_axes仅注解shape，模型内仍需用x.size(0)等动态推导尺寸，避免硬编码数值。
PyTorch转ONNX报错：Unsupported ONNX opset version
直接原因是模型导出时指定的 opset_version 超出当前 PyTorch 版本支持范围。比如用 PyTorch 1.12 调用 torch.onnx.export(..., opset_version=18)，就会报错 “Unsupported ONNX opset version: 18”，因为该版本最高只支持到 opset 17。
查清自己 PyTorch 支持的 opset 上限最稳妥的方式是运行：
import torch print(torch.onnx.supported_opset_version)
常见对应关系（非绝对，以实际输出为准）：
- PyTorch 1.12 → 最高 opset 17
- PyTorch 2.0 → 最高 opset 17（部分 patch 后可试 18，但不保证稳定）
- PyTorch 2.1+ → 默认支持 opset 18，部分算子需 opset 19 才能正确导出
建议策略：先用 torch.onnx.supported_opset_version 查上限，再设为该值或低 1 位；若后续推理引擎（如 ONNX Runtime）要求更高 opset，再升级 PyTorch 或改用 torch.export（PyTorch 2.2+ 推荐路径）。
立即学习“Python免费学习笔记（深入）”；
导出时报错：Exporting a function with control flow is not supported
这是典型动态控制流报错，本质是 PyTorch 的 torch.onnx.export（基于 tracing）无法记录运行时才决定的分支逻辑，比如：
-
if x.size(0) > 16:—— shape 依赖输入 batch，tracing 时无法预判 -
for i in range(x.shape[0]):—— loop 次数随输入变化 -
while condition:—— 循环终止条件不可静态推断
解决方向不是“绕过”，而是让控制流可追踪：
- 把
if改成torch.where或torch.nn.functional.upsample等可导出算子 - 把
for循环展开为固定次数（如最大迭代 10 次），并用torch.arange+torch.gather模拟索引 - 用
@torch.jit.script显式标注函数，并确保所有分支都覆盖（jit 可处理部分控制流，但 export 仍可能失败）
注意：PyTorch 2.2 引入的 torch.export.export（非 torch.onnx.export）原生支持部分动态控制流，但输出是 EXIR 格式，需额外转 ONNX，目前仍属实验阶段。
导出成功但 ONNX Runtime 推理报错：Node input ‘xxx’ does not exist
这通常不是导出失败，而是 ONNX 图结构异常——常见于使用了未注册的自定义算子、或 PyTorch 内部优化 pass 干扰了图结构（尤其在启用 dynamic_axes 时）。
关键检查点：
- 确认没在模型中调用未被 ONNX 支持的函数，如
torch.Tensor.tolist()、torch.cuda.synchronize()、print()等副作用操作 - 禁用不必要的导出参数：删掉
verbose=True（它可能触发调试图修改），避免keep_initializers_as_inputs=True（旧版遗留参数，新版默认 False，设为 True 可能引入冗余输入） - 用
onnx.checker.check_model(model)验证导出文件是否合法，它会抛出具体缺失节点名 - 用 Netron 打开 .onnx 文件，人工核对输入名是否与
dynamic_axes中声明的一致（例如声明了{'input': {0: 'batch'}}，但图里输入名却是'x'，就可能错位）
为什么加了 dynamic_axes 还是报 shape mismatch？
根本原因：dynamic_axes 只影响 ONNX 图的 shape annotation，不改变实际计算逻辑。如果模型内部硬编码了 shape（如 x.view(16, -1)），而输入 batch 不是 16，ONNX Runtime 在执行时仍会按固定 shape 解析，导致崩溃。
必须同步改造模型代码：
- 把
x.view(16, -1)改成x.view(x.size(0), -1)或x.reshape(x.size(0), -1) - 避免
torch.zeros(32, 64)这类静态尺寸，改用torch.zeros_like(x)[:, :64]或根据输入推导 - 确保所有
torch.nn.Linear、torch.nn.Conv2d等层的输入通道数与实际前序输出一致，不要靠注释“假设 batch=1”来蒙混
真正可靠的动态性，是模型 forward 里每一处 shape 都来自输入张量的 .size() 或 .shape，而不是数字字面量。
