使用R包text构建的模型执行预测时出现两类报错的问题咨询

问题背景 #

• 操作场景：调用R语言text包构建的模型开展预测操作，在不同运行环境下测试多类模型时先后触发两类报错，初步怀疑问题与hardhat依赖包有关
• 具体报错信息：

Error in forge_recipe_default_process_extras(extras, rec, baked_data,  : 
  unused argument (outcomes_lst$extras)


Error in out$extras$final(predictors_extras, outcomes_extras) : 
  argument "outcomes_extras" is missing, with no default

排查思路 #

• 优先查依赖版本匹配问题：这两类报错都是函数传参规则不匹配的典型表现，绝大多数诱因是关联包升级后调整了函数接口，旧调用逻辑适配不上新参数规则。重点核对text、hardhat、recipes三个强关联包的版本，确认训练模型时的包版本和当前预测环境的包版本是否存在跨大版本差异
• 其次查模型对象有效性：检查模型保存、加载流程是否存在对象损坏，比如是否跨大版本R环境存取模型、存取过程是否手动修改过模型对象的内部结构
• 最后做最小场景隔离验证：用text包自带的示例数据跑通从训练到预测的全流程，区分问题根源是全局环境依赖异常，还是自定义建模代码存在逻辑漏洞

解决方案 #

• 依赖版本适配：这是该类报错最高效的解决方式，将hardhat包降级到1.2.0稳定版即可（该版本未调整recipe处理流程的extra参数传参逻辑，和当前主流正式版text包适配性最好），降级完成后重启R会话再执行预测操作，降级执行代码参考：

# 未安装remotes包的先执行第一行安装
install.packages("remotes")
remotes::install_version("hardhat", version = "1.2.0")

• 模型重建：如果存在模型对象跨环境损坏的情况，在依赖版本匹配完成的当前环境中重新执行模型训练流程，生成新的模型对象后再调用预测接口
• 临时逻辑补丁：如果因项目需求不能降级hardhat版本，可以手动定位text包中调用forge_recipe_default_process_extras、out$extras$final两个函数的位置，补全缺失的outcomes_extras传参即可，该方案需要修改包内部源码，非必要不推荐使用

内容的提问来源于stack exchange，提问作者John