DeBERTa-v2: @torch.jit.script helpers emit torch 2.14 deprecation warnings at import

快速结论：该警告出现在导入 DeBERTa-v2 建模模块时，由六个 @torch.jit.script 装饰的辅助函数触发；若项目将 FutureWarning 设为 error，导入会直接失败，优先排查装饰器与 torch 版本组合。上游已通过 PR #50082 移除装饰器处理。

适用环境：transformers 5.16.1（问题同样存在于当时的主分支）、torch 2.14（NVIDIA NGC PyTorch 26.09 容器）、Python 3.12、aarch64。

最快修复方案：暂无已确认的一步修复方案。Issue 中验证过的方向是移除 make_log_bucket_position、c2p_dynamic_expand、p2c_dynamic_expand、pos_dynamic_expand、scaled_size_sqrt、build_rpos 六个函数上的 @torch.jit.script 装饰器，可优先尝试升级到包含 PR #50082 的版本；等值性测试仅为报告者在其生产环境中的验证，未经上游完整确认。

注意事项：设置 PYTORCH_JIT=0 无法屏蔽该警告，因为 torch.jit.script 在检查该标志前就发出警告；不要通过全局忽略 FutureWarning 掩盖问题。

问题场景

在 torch 2.14 环境下导入 transformers.models.deberta_v2.modeling_deberta_v2，或使用依赖 DeBERTa-v2 的推理、训练流程时触发。复现脚本将 FutureWarning 提升为异常，因此导入阶段即报错；不提升警告时表现为导入时刷出多条弃用警告。

报错原文

FutureWarning: `torch.jit.script` is deprecated. Please switch to `torch.compile` or `torch.export`.

原因分析

已确认原因：DeBERTa-v2 建模文件中有六个辅助函数使用 @torch.jit.script 装饰，torch 2.14 在导入时为每个被装饰函数发出弃用警告。PYTORCH_JIT=0 不能抑制该警告，因为警告发生在检查该环境变量之前。报告者指出，移除装饰器后，每个函数在 200 组随机输入上 eager 版本与 TorchScript 编译版本输出满足 torch.equal，结果不变。

环境排查

确认 torch 版本是否为 2.14；该弃用警告在更早版本中是否出现，Issue 未说明。
确认 transformers 版本是否为 5.16.1 或当时的主分支。
确认 Python 版本（Issue 为 3.12）与平台架构（Issue 为 aarch64）。
确认导入路径是否为 transformers.models.deberta_v2.modeling_deberta_v2，以及是否有其他模块间接导入它。
确认代码或测试配置中是否设置 warnings.simplefilter("error", FutureWarning) 或同类警告升级策略。
检查是否仍设置 PYTORCH_JIT=0 并误以为其可屏蔽警告。

解决步骤

先升级到包含 PR #50082 的 transformers 版本，再重新运行导入复现脚本；Issue 中提到该 PR 用于移除六个装饰器并补充回归检查。
若暂时无法升级，可参考 Issue 中的改动方向，在本地仅移除这六个函数上的 @torch.jit.script 装饰器：make_log_bucket_position、c2p_dynamic_expand、p2c_dynamic_expand、pos_dynamic_expand、scaled_size_sqrt、build_rpos。
修改后运行原复现脚本，确认导入时不再抛出 FutureWarning。
对 DeBERTa-v2 相关推理或训练流程做基本功能验证，确认输出与修改前一致。

验证方法

再次执行 warnings.simplefilter("error", FutureWarning) 后导入 DeBERTa-v2 建模模块，应不再抛出上述 FutureWarning；同时确认模型前向输出正常，如做了本地等价性检查，可在随机输入上对比 eager 与 TorchScript 编译版本的 torch.equal 结果。