Rcpp包加载报错：共享库存在符号却提示不存在

排查方向与解决方法 #

1. 静态库链接顺序搞反了 #

静态库的链接顺序是关键——依赖库必须放在被依赖的库后面。比如my_lib依赖libA.a和libB.a，Makevars里的PKG_LIBS得这么写：

PKG_LIBS = -L/path/to/libs -lmy_lib -lA -lB

别把所有静态库打包成一个文件再链接，单独指定每个库才能保证符号正确解析。

2. 符号被编译选项隐藏了 #

Ubuntu下GCC默认会隐藏部分符号，哪怕nm能查到，动态加载时也读不到。给Makevars加个编译选项：

PKG_CXXFLAGS = -fvisibility=default

同时要确认my_lib和它的依赖库编译时也用了这个选项，不然静态库内部的符号还是会被藏起来。

3. Docker挂载卷的权限坑 #

挂载过来的.so文件权限可能不对，R读不到符号。先查权限：

ls -l /path/to/my_package/src/my_package.so

要是权限不够，就改成755：

chmod 755 /path/to/my_package/src/my_package.so

另外编译的时候，确保Docker容器里的用户对挂载目录有读写权限，不然生成的文件权限会异常。

4. Rcpp模块注册有没有写错 #

检查你的模块代码是不是正确，比如：

#include <Rcpp.h>
#include "my_lib/Client.h"

using namespace Rcpp;

RCPP_MODULE(ClientCaller) {
    class_<Client>("Client")
      .constructor<std::string>()
      .method("connect", &Client::connect)
      .method("disconnect", &Client::disconnect);
}

还要确认这个.cpp文件被包含在包的编译列表里——DESCRIPTION的LinkingTo要加Rcpp，src/Makevars里的PKG_SOURCES得包含这个文件。

5. 编译环境不兼容 #

my_lib和依赖库的编译环境得和R包一致：

• 检查C标准：R 4.0+默认用C11，确保静态库也是用-std=c++11或更高版本编译的。
• 别混着用不同版本的GCC，Docker里统一用同一个版本编译所有东西。

6. 清理编译残留 #

Docker里可能有旧的编译缓存，导致加载的是老的.so文件。先清一下：

devtools::clean_dll()

然后重新安装包：

R CMD INSTALL --preclean my_package

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