使用lldb-server开展安卓LLDB远程调试报端口连接失败如何解决

故障根因及对应修复步骤 #

1. 平台模式选择错误（最高发诱因） #

remote-android是LLDB预留的ADB通道专用平台，该模式下LLDB会自动通过ADB连接设备、推送匹配版本的lldb-server并启动服务，不会走普通TCP直连的握手逻辑，手动启动lldb-server监听TCP端口时选择该平台，必然出现端口连接报错，与网络连通性无关。
修复操作：

• 先终止待调试设备上已运行的lldb-server进程，重新执行监听命令（注意修正原命令的路径错误：绝对路径前不需要加.，否则会从当前工作目录查找子路径，容易出现执行文件不匹配问题）：

/data/local/tmp/lldb-server platform --listen "0.0.0.0:2000" --server

部分旧版lldb-server不识别*作为通配监听地址，直接写0.0.0.0可以规避监听无效问题，执行后再用netstat确认0.0.0.0:2000处于LISTEN状态即可。

• 主机端启动LLDB后，替换平台选择命令为通用远程Linux平台，再执行连接：

platform select remote-linux
platform connect connect://192.168.201.132:2000

90%以上的同场景报错在这一步即可解决。 #

2. 客户端与服务端版本/编译链不匹配 #

LLDB对客户端、服务端的版本一致性要求极高，跨大版本、不同编译链（GNU libc/Bionic libc）编译的二进制哪怕版本号标识一致，也可能出现握手失败问题。Debian源通过apt安装的LLDB是针对Debian系统的GNU libc环境编译的，和NDK中提取的、针对安卓Bionic libc环境编译的lldb-server存在天然兼容问题，这也是换Debian Buster/Sid都复现报错、甚至本地跑lldb-server也连不上的核心原因。
修复操作：

• 放弃使用apt安装的LLDB客户端，从你提取lldb-server的同一份NDK24包中，取出适配Arm64架构的预编译LLDB客户端，路径为NDK压缩包内的toolchains/llvm/prebuilt/linux-aarch64/目录，将整个目录拷贝到你的Debian rootfs中，直接使用该目录下bin/lldb二进制作为客户端，该二进制和你推送到待调试设备的lldb-server为同版本、同编译链构建，不存在协议兼容问题。
• 确认推送到armv7待调试设备的lldb-server是NDK内linux-arm架构目录下的二进制，不要误推arm64版本，否则即使设备开了32位兼容层能运行服务，也会出现握手异常。

额外排查项 #

如果上述操作完成后仍无法连接，依次做以下检查：

• 在主机Debian环境执行nc -zv 192.168.201.132 2000确认TCP端口连通性，安卓10及以上版本默认会对非系统级应用监听的端口增加防火墙限制，可先在待调试设备执行setenforce 0临时关闭SELinux后再尝试连接。
• 确认热点网络没有做客户端隔离，部分设备开热点时默认开启AP隔离，会导致连接热点的设备之间无法互相通信，gdb能正常连接的话一般不存在这个问题，可作为兜底检查项。

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