调试策略 • 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 或 Windows 上通过 MinGW 或 Cygwin 找到）和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 命令列表。