library/org.meshtastic.mqtt/MqttException

MqttException

sealed class MqttException : Exception

Base exception for all MQTT client errors.

Every exception thrown by MqttClient extends this type, so consumers can catch MqttException to handle any library error, or match specific subtypes for fine-grained error handling.

Example

try {
    client.connect(endpoint)
} catch (e: MqttException.ConnectionRejected) {
    println("Broker rejected: ${e.reasonCode}")
} catch (e: MqttException.ProtocolError) {
    println("Protocol violation: ${e.message}")
} catch (e: MqttException) {
    println("MQTT error: ${e.message}")
}

Inheritors

ConnectionRejected

Types

class ConnectionLost(reasonCode: ReasonCode, message: String, cause: Throwable? = null) : MqttException

The connection was lost unexpectedly.

ConnectionRejected

class ConnectionRejected(reasonCode: ReasonCode, message: String, cause: Throwable? = null, val serverReference: String? = null) : MqttException

The broker rejected the CONNECT request (§3.2).

class ProtocolError(reasonCode: ReasonCode, message: String, cause: Throwable? = null) : MqttException

A protocol-level error occurred.

Properties

expect open val cause: Throwable?

expect open val message: String?

val reasonCode: ReasonCode

The MQTT 5.0 reason code associated with this error.