Python BlueZ配对代理正常，C#(Tmds.DBus)RequestConfirmation方法报错排查

核心排查点与解决方案 #

1. 核对C#接口的DBus方法签名与参数定义

Tmds.DBus对DBus方法签名的解析严格要求包裹参数列表的括号，这是最常见的错误点：

• 确保RequestConfirmation方法的DBusMethod属性签名为"(ou)"（带括号），而非"ou"
• 参数顺序必须严格匹配BlueZ定义：第一个参数为ObjectPath类型的设备路径，第二个为uint类型的配对密钥（passkey）
• 方法名必须严格为RequestConfirmation（DBus接口方法大小写敏感）

示例正确接口定义片段：

[DBusInterface("org.bluez.Agent1")]
public interface IBlueZAgent : IDBusObject
{
    [DBusMethod(Signature = "(ou)")]
    Task RequestConfirmationAsync(ObjectPath device, uint passkey);
    
    // 必须实现Agent1接口的所有必要方法，否则BlueZ会判定接口不完整
    [DBusMethod(Signature = "(o)")]
    Task<string> RequestPinCodeAsync(ObjectPath device);
    
    [DBusMethod(Signature = "()")]
    Task CancelAsync();
}

2. 验证代理注册的Capability设置

BlueZ仅在代理Capability匹配时才会触发RequestConfirmation调用：

• 注册代理时需传入"DisplayOnly"或"DisplayYesNo"这类需要显示密钥的Capability，若设置为"NoInputNoOutput"则不会触发该方法
• 注册代码示例：

var agentManager = connection.CreateProxy<IAgentManager>("org.bluez", new ObjectPath("/org/bluez"));
await agentManager.RegisterAgentAsync(agentPath, "DisplayOnly");
await agentManager.RequestDefaultAgentAsync(agentPath);

3. 检查BlueZ版本兼容性

Ubuntu Bookworm Lite默认的BlueZ版本为5.66，确认该版本的org.bluez.Agent1接口确实包含RequestConfirmation方法：

• 终端执行bluetoothd --version查看版本
• 用gdbus introspect --system --dest org.bluez --object-path /org/bluez/hci0 --interface org.bluez.Agent1直接查看接口定义，确认方法签名为(ou)

4. 调试DBus通信

用dbus-monitor监控系统总线，确认BlueZ是否发送了RequestConfirmation调用：

dbus-monitor --system "type='method_call',interface='org.bluez.Agent1'"

对比监控到的调用参数与C#代码的参数定义是否完全匹配。

5. 升级Tmds.DBus版本

Tmds.DBus v0.21.2存在部分签名解析的已知问题，尝试升级到最新稳定版（如v0.22.x）：

dotnet add package Tmds.DBus --version 0.22.0

内容的提问来源于stack exchange，提问作者Kévin Isabelle