为旧R包Hmisc添加Rcpp函数时，遭遇C++二进制对象未找到错误

核心原因 #

这个错误的本质是新C++函数的符号未被正确注册到包的动态库中，根源在于自定义init.c与Rcpp自动注册机制的冲突，以及NAMESPACE中符号前缀配置的覆盖问题。

分步解决 #

1. 调整NAMESPACE配置 #

原配置中.fixes='F_'会给所有通过该useDynLib注册的符号强制添加F_前缀，但Rcpp生成的C符号（_Hmisc_hlqest）不需要这个前缀。需要分开处理旧Fortran代码和新C代码的注册：

export('pMedian')
# 仅给旧Fortran代码指定前缀，列出旧Fortran符号名（替换为实际名称）
useDynLib(Hmisc, .registration=TRUE, .fixes='F_', .objects = c('fortran_routine1', 'fortran_routine2'))
# 单独注册Rcpp生成的C++符号，无需前缀
useDynLib(Hmisc, .registration=TRUE, .objects = c('_Hmisc_hlqest'))

2. 修复src/init.c与Rcpp注册的冲突 #

自定义的init.c会覆盖Rcpp自动生成的注册逻辑，导致C++函数符号未被加载。有两种处理方式：

方式A：合并注册逻辑到Rcpp机制（推荐）

删除原src/init.c，新建src/registerFortran.cpp，将旧Fortran注册代码迁移到这里，并调用Rcpp的注册函数：

#include <R_ext/Rdynload.h>
#include <Rcpp.h>

// 声明旧Fortran函数（替换为实际函数名）
extern void F_fortran_routine1();
extern void F_fortran_routine2();

static const R_FortranMethodDef FortranEntries[] = {
    {"fortran_routine1", (DL_FUNC)&F_fortran_routine1, 2}, // 最后一个数字为函数参数个数
    {"fortran_routine2", (DL_FUNC)&F_fortran_routine2, 3},
    {NULL, NULL, 0}
};

extern "C" void R_init_Hmisc(DllInfo* dll) {
    // 注册旧Fortran符号
    R_registerRoutines(dll, NULL, NULL, FortranEntries, NULL);
    R_useDynamicSymbols(dll, FALSE);
    R_forceSymbols(dll, TRUE);
    // 调用Rcpp自动注册函数，加载C++符号
    Rcpp::registerRoutines(dll);
}

方式B：修改现有init.c

如果保留原init.c，需要添加Rcpp注册函数的调用：

#include <R_ext/Rdynload.h>
// 原Fortran函数声明
extern void F_old_fortran_routine1();
extern void F_old_fortran_routine2();
// 声明Rcpp的注册函数
extern void Rcpp_init_Hmisc(DllInfo*);

static const R_FortranMethodDef FortranEntries[] = {
    {"old_fortran_routine1", (DL_FUNC)&F_old_fortran_routine1, 2},
    {"old_fortran_routine2", (DL_FUNC)&F_old_fortran_routine2, 3},
    {NULL, NULL, 0}
};

void R_init_Hmisc(DllInfo* dll) {
    // 原有Fortran注册逻辑
    R_registerRoutines(dll, NULL, NULL, FortranEntries, NULL);
    R_useDynamicSymbols(dll, FALSE);
    R_forceSymbols(dll, TRUE);
    // 新增：调用Rcpp注册函数
    Rcpp_init_Hmisc(dll);
}

3. 重新生成注册代码并构建包 #

在R中执行以下步骤：

# 重新生成Rcpp注册文件
Rcpp::compileAttributes()
# 清理旧编译文件
devtools::clean_dll()
# 重新构建并安装包
devtools::install()

4. 验证符号注册 #

加载包后，检查动态库符号是否包含目标函数：

library(Hmisc)
# 查看已加载的动态库符号
getLoadedDLLs()$Hmisc$symbols

确认_Hmisc_hlqest在列表中，再测试pMedian(1:5)即可正常运行。

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