Rcpp compileAttributes生成void参数致CRAN LTO构建失败求助

问题背景 #

在开发使用Rcpp和testthat Catch单元测试的R包（如BayesMallows）时，CRAN构建过程中触发LTO（链接时优化）失败，报错信息为：

LTO build failure: type violates the C++ One Definition Rule

最小复现步骤：

• 创建Rcpp包：执行Rcpp::Rcpp.package.skeleton()并进入包目录
• 添加Catch单元测试：执行testthat::use_catch()
• 修改DESCRIPTION文件为指定内容后，运行Rcpp::compileAttributes()，会在src/RcppExports.cpp中生成错误的函数声明：RcppExport SEXP run_testthat_tests(void *);
• 手动修改为RcppExport SEXP run_testthat_tests(SEXP);可临时解决，但每次执行Rcpp::compileAttributes()会恢复错误声明。

环境信息：R 4.3.1，Mac/Windows平台，testthat 3.1.10，Rcpp 1.0.11，Mac下Apple clang 14.0.3。

问题原因 #

testthat为Catch测试生成的run_testthat_tests函数，实际定义的参数类型是SEXP，但Rcpp::compileAttributes()在扫描代码时，错误地将该函数的参数识别为void*，并在RcppExports.cpp中生成了不匹配的声明。LTO构建会严格校验所有符号的声明与定义一致性，这种参数类型不匹配直接违反了C++的One Definition Rule（ODR），导致构建失败。

解决方案 #

1. 升级依赖版本（推荐） #

该问题是testthat与Rcpp的版本兼容性bug，升级到修复后的版本即可彻底解决：

• 升级testtest到3.2.0及以上：该版本调整了测试入口函数的生成逻辑，避免被Rcpp的属性扫描工具错误解析。
• 同步升级Rcpp到1.0.12及以上，确保两者的符号解析逻辑一致。

执行以下R命令完成升级：

install.packages(c("testthat", "Rcpp"))

升级后，重新运行testthat::use_catch()和Rcpp::compileAttributes()，生成的RcppExports.cpp中将不再包含错误的run_testthat_tests声明。

2. 手动排除函数扫描（临时兼容方案） #

若无法升级依赖版本，可通过注释让Rcpp忽略该函数的扫描：

1. 找到testthat生成的测试入口文件（通常路径为tests/testthat/testthat_catch.cpp）
2. 在run_testthat_tests函数的声明前添加// [[Rcpp::ignore]]注释：

   // [[Rcpp::ignore]]
   RcppExport SEXP run_testthat_tests(SEXP) {
       // 原有测试执行代码
   }
   

3. 重新运行Rcpp::compileAttributes()，此时src/RcppExports.cpp中将不再生成错误的函数声明。

3. 自定义RcppExports生成模板（进阶方案） #

在包根目录创建RcppExports.cpp.in文件，手动编写正确的函数声明模板，替代自动生成的内容。但这种方法需要长期维护模板，仅适合特殊场景下使用。

内容的提问来源于stack exchange，提问作者Øystein S