From e69e7c3a68c3035667b54300204605f052ebe638 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=B7=AF=E6=8C=AF=E5=87=AF?= <l>
Date: Thu, 9 Oct 2025 16:56:16 +0800
Subject: [PATCH 1/2] fix: duplicate unique identifiers in MeasureRow column
 headers

---
 src/Body/MeasureRow.tsx  |  6 +--
 src/utils/measureUtil.ts | 93 ++++++++++++++++++++++++++++++++++++++++
 2 files changed, 96 insertions(+), 3 deletions(-)
 create mode 100644 src/utils/measureUtil.ts

diff --git a/src/Body/MeasureRow.tsx b/src/Body/MeasureRow.tsx
index 1211839c6..87438e502 100644
--- a/src/Body/MeasureRow.tsx
+++ b/src/Body/MeasureRow.tsx
@@ -5,6 +5,7 @@ import isVisible from '@rc-component/util/lib/Dom/isVisible';
 import { useContext } from '@rc-component/context';
 import TableContext from '../context/TableContext';
 import type { ColumnType } from '../interface';
+import { prepareMeasureTitle } from '../utils/measureUtil';
 
 export interface MeasureRowProps {
   prefixCls: string;
@@ -37,9 +38,8 @@ const MeasureRow: React.FC<MeasureRowProps> = ({
         {columnsKey.map(columnKey => {
           const column = columns.find(col => col.key === columnKey);
           const rawTitle = column?.title;
-          const titleForMeasure = React.isValidElement<React.RefAttributes<any>>(rawTitle)
-            ? React.cloneElement(rawTitle, { ref: null })
-            : rawTitle;
+          const titleForMeasure = prepareMeasureTitle(rawTitle);
+
           return (
             <MeasureCell
               key={columnKey}
diff --git a/src/utils/measureUtil.ts b/src/utils/measureUtil.ts
new file mode 100644
index 000000000..5fa3834b5
--- /dev/null
+++ b/src/utils/measureUtil.ts
@@ -0,0 +1,93 @@
+import * as React from 'react';
+
+/**
+ * Props that should be filtered out from measure row elements to avoid DOM conflicts
+ */
+const FILTERED_PROPS = [
+  // Unique identifiers that shouldn't be duplicated in DOM
+  'id',
+  'data-testid',
+  'data-test-id',
+  'data-cy', // Cypress
+  'data-qa',
+  'data-automation-id',
+  'data-id',
+  'data-key',
+
+  // Event handlers that are unnecessary in hidden measure elements
+  'onClick',
+  'onMouseEnter',
+  'onMouseLeave',
+  'onFocus',
+  'onBlur',
+  'onKeyDown',
+  'onKeyPress',
+  'onKeyUp',
+  'onDoubleClick',
+  'onContextMenu',
+
+  // Accessibility props that might reference other elements and cause conflicts
+  'aria-describedby',
+  'aria-labelledby',
+  'aria-controls',
+  'aria-owns',
+
+  // Form-related props that might conflict
+  'name',
+  'htmlFor',
+  'for',
+] as const;
+
+/**
+ * Filter props from a React element that might cause DOM conflicts in measure row
+ * @param element - The React element to filter
+ * @param deep - Whether to recursively filter nested elements
+ * @returns A new React element with filtered props
+ */
+export function filterMeasureProps<T = any>(
+  element: React.ReactElement<T>,
+  deep: boolean = true,
+): React.ReactElement<T> {
+  if (!React.isValidElement(element)) {
+    return element;
+  }
+
+  const filteredProps = { ...element.props } as any;
+
+  FILTERED_PROPS.forEach(prop => {
+    filteredProps[prop] = undefined;
+  });
+
+  // Recursively filter children if deep filtering is enabled
+  if (deep && filteredProps.children) {
+    filteredProps.children = filterMeasureChildren(filteredProps.children);
+  }
+
+  return React.cloneElement(element, filteredProps);
+}
+
+/**
+ * Recursively filter children elements
+ * @param children - React children to filter
+ * @returns Filtered children
+ */
+function filterMeasureChildren(children: React.ReactNode): React.ReactNode {
+  return React.Children.map(children, child => {
+    if (React.isValidElement(child)) {
+      return filterMeasureProps(child, true);
+    }
+    return child;
+  });
+}
+
+/**
+ * Prepare title content for use in measure row
+ * @param title - The original title content
+ * @returns Filtered title safe for measure row usage
+ */
+export function prepareMeasureTitle(title: React.ReactNode): React.ReactNode {
+  if (React.isValidElement(title)) {
+    return filterMeasureProps(title, true); // Enable deep filtering
+  }
+  return title;
+}

From a8636fb1dcec069439c54028b8bf0e6d881f37a4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=B7=AF=E6=8C=AF=E5=87=AF?= <l>
Date: Thu, 9 Oct 2025 17:11:03 +0800
Subject: [PATCH 2/2] fix: Nullify ref for filteredProps

---
 src/utils/measureUtil.ts | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/utils/measureUtil.ts b/src/utils/measureUtil.ts
index 5fa3834b5..b21e412e4 100644
--- a/src/utils/measureUtil.ts
+++ b/src/utils/measureUtil.ts
@@ -58,6 +58,9 @@ export function filterMeasureProps<T = any>(
     filteredProps[prop] = undefined;
   });
 
+  // Nullify ref to avoid warnings and conflicts
+  filteredProps.ref = null;
+
   // Recursively filter children if deep filtering is enabled
   if (deep && filteredProps.children) {
     filteredProps.children = filterMeasureChildren(filteredProps.children);