调试策略 • Arrow R 包

如果您是使用 Arrow 代码的开发人员，那么该包对 tidy eval 和 C++ 的使用要求您具备扎实的调试策略。在本文中，我们推荐一些方法。

调试 R 代码

通常，我们发现使用交互式调试（例如调用 browser()），您可以在特定环境中检查对象，比 print() 语句等更简单的技术更高效。

段错误后获取更具描述性的 C++ 错误消息

如果您在 RStudio IDE 中工作，如果发生段错误，您的 R 会话将被中止。如果您在命令行 R 会话中重新运行代码，会话不会自动中止，因此可以复制伴随段错误的错误消息。这是一个编写时存在的错误的示例。

> S3FileSystem$create()

 *** caught segfault ***
address 0x1a0, cause 'memory not mapped'

Traceback:
 1: (function (anonymous, access_key, secret_key, session_token,     role_arn, session_name, external_id, load_frequency, region,     endpoint_override, scheme, background_writes) {    .Call(`_arrow_fs___S3FileSystem__create`, anonymous, access_key,         secret_key, session_token, role_arn, session_name, external_id,         load_frequency, region, endpoint_override, scheme, background_writes)})(access_key = "", secret_key = "", session_token = "", role_arn = "",     session_name = "", external_id = "", load_frequency = 900L,     region = "", endpoint_override = "", scheme = "", background_writes = TRUE,     anonymous = FALSE)
 2: exec(fs___S3FileSystem__create, !!!args)
 3: S3FileSystem$create()

此输出提供了 R 追溯；但是，它不提供有关段错误发生的 C++ 代码的确切行号的任何信息。为此，您需要将 C++ 调试器附加到 R 上运行。

使用 C++ 调试器运行 R 代码

由于 Arrow 的核心是 C++ 代码，当错误源于 C++ 而非 R 层时，调试代码有时会很棘手。如果您正在添加触发 C++ 错误的新代码（或在现有代码中发现错误），这可能会导致段错误。如果您在 RStudio 中工作，会话会中止，您可能无法检索诊断和/或报告错误所需的错误消息。解决此问题的一种方法是找到导致错误的代码，并使用 C++ 调试器运行 R。

如果您使用 macOS 并使用 Apple 安装程序安装了 R，您将无法使用调试器运行 R；请参阅此处的说明，了解其原因和解决方法。

首先，使用调试器加载 R。最常见的调试器是 gdb（通常在 Linux 上找到，有时在 macOS 上，或通过 MinGW 或 Cygwin 在 Windows 上找到）和 lldb（默认的 macOS 调试器）。

在我的例子中是 gdb，但如果您使用的是 lldb 调试器（例如，如果您在 Mac 上），只需在此处交换该命令即可。

R -d gdb

接下来，运行 R。

run

您现在应该处于一个附加了 C++ 调试器的 R 会话中。这看起来类似于正常的 R 会话，但带有额外的输出。

现在，运行您的代码——可以直接在会话中运行，也可以从文件中源文件。如果代码导致段错误，您将获得额外的输出，可以用于诊断问题或作为额外信息附加到问题中。

这是前面示例中显示的段错误的调试器输出。您可以在此处看到触发段错误的确切行号包含在输出中。

> S3FileSystem$create()

Thread 1 "R" received signal SIGSEGV, Segmentation fault.
0x00007ffff0128369 in std::__atomic_base<long>::operator++ (this=0x178) at /usr/include/c++/9/bits/atomic_base.h:318
318       operator++() noexcept

如果您的会话挂起，获取调试器输出

上述说明可以在发生段错误时提供宝贵的额外上下文。但是，偶尔会有一些情况，错误可能导致您的会话无限期挂起而不会发生段错误。在这种情况下，中断调试器并从所有正在运行的线程生成回溯可能对诊断有用。

为此，首先，按 Ctrl/Cmd 和 C 中断调试器，然后运行

thread apply all bt

这将生成大量输出，但这些信息在识别问题原因时很有用。

进一步阅读

以下资源提供了调试 R 代码的详细指南

有关在 R 中使用 C++ 调试器的出色深入指南，请参阅David Vaughan 的这篇博客文章。

您可以在 LLDB 网站上找到等效的 gdb 和 lldb 命令列表。