paho-mqtt 2.x: mqtt.Client("my-id") raises 'TypeError: Unsupported callback API version: version 2.0 added a callback_api_version'
In paho-mqtt 2.x, pass the client ID by keyword and choose the callback API explicitly: mqtt.Client(mqtt.CallbackAPIVersion.VERSION2, client_id="rpi_subscriber"). The first positional parameter is now callback_api_version. Old 1.x code like mqtt.Client("rpi_subscriber") fails with TypeError: Unsupported callback API version: version 2.0 added a callback_api_version, see docs/migrations.rst for details.
mqtt.Client(client_id="x") with no version still works, but it uses VERSION1 and warns DeprecationWarning: Callback API version 1 is deprecated, update to latest version.
With VERSION2, the callback signatures change. If you keep the old ones, the callbacks fail when they're called:
def on_connect(client, userdata, flags, reason_code, properties):
if reason_code.is_failure: print("connect failed", reason_code); return
client.subscribe("sensors/#")
def on_disconnect(client, userdata, disconnect_flags, reason_code, properties): ...
def on_subscribe(client, userdata, mid, reason_code_list, properties): ...
def on_message(client, userdata, msg): ... # unchangedreason_code is a ReasonCode object with .is_failure, not the old int rc. Requirements files with paho-mqtt>=1.6 or no pin will pick up 2.x on a fresh Raspberry Pi install. Verified with paho-mqtt 2.2.0 on Python 3.11.