MatrixOne v26.4.1.3 Release Notes¶

Release Date: July 22, 2026 MatrixOne Version: v26.4.1.3 (v4.1.3)

MatrixOne v26.4.1.3 is a patch release that fixes a potential deadlock hang in distributed transactions in multi-CN deployments.

Bug Fixes¶

Owner-local remote lock deadlock hang (#25849): Fixed a potential hang in distributed transactions when the lock service encountered an owner-local deadlock. Previously, transactions in multi-CN deployments could hang indefinitely when a deadlock occurred between remote exclusive lock requests on the same lock-table owner CN. The fix adds an owner-local deadlock fast-path detection that runs synchronously before adding a waiter to the distributed detector queue. When an owner-local deadlock cycle is found, one of the involved transactions is aborted with a deadlock error (ErrDeadLockDetected, 20601) instead of hanging. A new internal error code ErrRemoteLockWaitTimeout (20709) was introduced for tracking owner-side wait timeouts on the new remote-lock-owner-wait-timeout budget; during rolling upgrades, this error is mapped to the existing deadlock error for backward compatibility.

The fix introduces a new lock service configuration parameter remote-lock-owner-wait-timeout (default: 2 minutes, set to "0s" to disable) that caps how long a lock owner waits for remote lock RPC handling. This parameter is configured in the CN lock service configuration section.

New Prometheus metrics have been added for monitoring the lock service deadlock detection subsystem:

Metric	Type	Description
`mo_lockservice_deadlock_detector_enqueue_total`	Counter (label: `result`)	Total deadlock detector enqueue attempts, labeled by outcome (`closed`, `dedup_skipped`, `queued`, `busy`)
`mo_lockservice_deadlock_owner_local_total`	Counter (label: `result`)	Total owner-local deadlock fast path results
`mo_lockservice_remote_lock_owner_timeout_total`	Counter (labels: `granularity`, `mode`)	Total remote lock owner-side wait timeouts
`mo_lockservice_deadlock_detector_queue_depth`	Gauge	Current depth of the deadlock detector queue

This document is generated by the docs sync agent based on the MatrixOne source diff and reviewed by humans via pull request.