【产品动态】Oracle NetSuite SuiteScript 2.1 迁移路线解读：从盘点到迁移，做好 2028.2 前的准备

Oracle 给出的时间表：

四步推进，2028.1 是重要节点

根据 Oracle SuiteAnswers 官方文章，本次迁移被安排为四个版本逐步推进：

2028.2 才是最后期限，但在此之前还有一个更早的节点是容易被忽略的。

按 Oracle 当前公布的迁移计划，到 2028.1 Oracle NetSuite 会把账户里所有标注为 2.0 或 2.x 版本的脚本，统一切换到新的 2.1 环境中运行。这个切换是系统默认完成的——不需要开发重新上传代码，也不需要任何人签字确认。

Tips：Oracle NetSuite 一年发布两个大版本，客户账户是分批逐步升级的。所以「2028.2」不是一个具体日期，而是一个时间窗口，您的账户究竟在哪一天切换，取决于Oracle NetSuite 排列的档期。

受影响的是 JSDoc 标签标注为 @NApiVersion 2.0 与 @NApiVersion 2.x 的脚本。

改写只是第一步

后续测试与验证不容忽视

从技术上看，1.0 / 2.0 到 2.1 的代码改写并不复杂，Oracle 也已提供了官方的自动化能力：SuiteCloud Agent Skills：Oracle 采用 agentskills.io 开放标准发布的知识包，可在 25 个以上主流 AI 编码平台及 SuiteCloud Developer Assistant 中使用。但是真正的工作量集中在改写之后：

• 测试用例设计与 UAT：改动后的行为需要在真实业务入口上被验证，而不是只看代码能不能跑通；

• 回归验证：脚本往往与审批流、集成接口、计划任务相互耦合，一个 User Event 的改动可能影响另一段早已无人维护的逻辑；

• 上线切换：要与月结、季结、大促等业务节奏错开；

• 需求工程与历史定制重构：迁移过程中常会发现「当年为什么这么写」已无人知晓，此时需要重新梳理业务需求，甚至对历史定制做重构。

换言之——把 @NApiVersion 1.0  改成 2.1，是整个迁移里最简单的动作；证明同一套业务流程、集成、审批与财务控制在 2.1 下依然正确，才是难点。

Hitpoint Cloud 能做什么

Hitpoint Cloud 自 2009 年起专注于 Oracle NetSuite 产品，拥有超百人的实施与开发团队，服务超过 400 家企业客户，并是 Oracle NetSuite 在中国的首个授权培训中心。

针对本次 SuiteScript 2.1 迁移，我们提供从盘点到上线的全流程服务：

① 脚本资产盘点与健康评估：梳理账户内全部脚本与部署，输出包含脚本/部署 ID、当前版本标注、脚本类型、涉及的记录类型与事件、对外调用、最后执行时间、业务责任人的清单，并按「旧运行时 × 业务影响 × 执行频率 × 外部副作用」排出迁移优先级队列。

② 迁移方案设计与代码改写：基于 Oracle 官方 SuiteCloud Agent Skills 与 Hitpoint Cloud 自有 Agent平台 Hitpoint XAgent 的 NetSuite AI Skill Suite 进行转换。我们已在公司内部强制要求：所有新脚本一律采用 SuiteScript 2.1，并要求 AI 生成的新脚本同样遵循 2.1。 对 Oracle API Map 中无直接对应项的 API，由资深开发逐个人工复核与重构。

③ 第三方 SuiteApp / Bundle 审查与处置建议 ：对账户内已安装的第三方 SuiteApp 与 Bundle 做兼容性审查，给出处置建议（等待发布方升级 / 替换 / 自行重构），并协助跟进处理。

④ UAT、回归测试与上线保障：制定测试用例、在 Release Preview / Sandbox 中按真实入口执行回归验证、安排与业务节奏错开的上线切换窗口，这是整个迁移过程中最需要业务经验与项目协同的环节。

⑤ Oracle 官方事务对接：升级过程中与 Oracle 官方相关的沟通与事务处理，由我们统一跟进。

顺带一提

还有另一个升级也在窗口期内

除了 SuiteScript 版本升级，Oracle NetSuite 的集成认证机制也在发生变化。

Oracle 已公布，自 2027.1 起将不再允许新建使用 TBA 的 SOAP Web Services、REST Web Services 和 RESTlets 集成；现有 TBA 集成则计划在后续版本逐步停止支持。

两项升级，一动「内部脚本」，一动「外部接口」，时间点前后相继。如果您的账户两者都涉及，把它们放在同一次评估里做往往更省事——同一批脚本盘点工作可以复用，同一次 Release Preview 验证也可以覆盖两条线。

我们提供 「Oracle NetSuite 技术栈双升级评估」，一次梳理 OAuth 2.0 与 SuiteScript 2.1 两项升级的影响范围与迁移计划。

现在可以做的三件事

• 先确认影响范围

  弄清楚账户中到底有多少 1.0、2.0、2.x 脚本，以及哪些脚本仍在实际业务中运行。

• 先判断哪些可以不迁

  停用、重复、已经被替代的历史脚本，可以优先清理，避免把不再需要的定制也纳入迁移范围。

• 尽早制定迁移计划

  根据脚本数量、业务重要程度、第三方依赖及企业自身开发资源，判断这是一次小规模技术调整，还是需要提前规划的专项项目。

如果您的 Oracle NetSuite 账户已经出现「Update Needed」提示，但目前还不清楚受影响的脚本数量、迁移工作量以及第三方 SuiteApp 的影响范围，可以先做一次专项评估。

Hitpoint Cloud 可结合账户现状，协助梳理影响范围、评估迁移风险，并制定相应的升级计划。

点击阅读原文和我们聊一聊

了解 SuiteScript 2.1 升级方案

【新客快讯 | 祥源生物】Oracle NetSuite×Hitpoint Cloud 助力生命科学企业数字化管理升级

【云货分享】中企出海进入「扎根之年」，AI 原生 ERP 为何成了必答题？

【云货分享】选云ERP怕踩坑？5个维度看清"真云"与"伪云"