R包自定义函数导出后在Shiny应用中出现名称遮蔽冲突如何解决

根因确认 #

报错的核心原因有两点：

1. 调用与定义的函数名不匹配：你实际定义导出的函数名为 read_aws_step2_sden1428_ga_q2，但Shiny应用app_server.R第30行调用的是多了ux_metrics前缀的read_aws_ux_metrics_step2_sden1428_ga_q2，二者名称不一致。
2. 包构建历史残留导致的名称遮蔽：之前运行devtools::document()产生的冲突，大概率是旧版本包的导出记录、已加载的包环境残留导致的同名遮蔽。

解决操作 #

• 修正名称不匹配问题
  两种方案二选一即可：

  1. 改调用侧：将app_server.R第30行的调用代码替换为你实际导出的函数名：

  sw.uxdashboard::read_aws_step2_sden1428_ga_q2()
  

  2. 改定义侧：如果你需要保留调用侧的ux_metrics前缀，直接修改你编写的函数定义名即可：

  # 把函数名改为和调用侧一致
  read_aws_ux_metrics_step2_sden1428_ga_q2 <- function() {
    x_dt <- sw.uxdashboard::aws_read_table(table_name = sw.config$step2_sden1428_ga_q2)
  }
  

• 清理构建残留消除名称遮蔽
  按顺序执行以下操作：

1. 删除包根目录下自动生成的NAMESPACE文件，以及man文件夹中对应该函数的.Rd帮助文档
2. 重启R会话清空当前加载的所有环境，避免旧版本包的函数遮蔽
3. 重新运行devtools::document()生成新的NAMESPACE文件，确认文件内导出语句为export(你最终选择的函数名)
4. 强制重新安装本地包：运行devtools::install_local(force = TRUE)覆盖旧版本安装包

• 验证结果
  安装完成后运行以下代码确认函数导出正常：

# 替换为你最终的函数名
exists("read_aws_step2_sden1428_ga_q2", where = asNamespace("sw.uxdashboard"), inherits = FALSE)

返回TRUE即说明导出正常，再启动Shiny应用即可解决报错。

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