fix(shadow): classify source-change refresh as stale

ruoyi-admin/src/main/java/com/ruoyi/algorithm/shadow/ShadowObservationGateway.java

@@ -283,6 +283,17 @@ public class ShadowObservationGateway {
                 metrics.increment(ShadowSkipReason.CONCURRENT);
             } catch (Exception shadowFailure) {
                 coordinator.failRefresh(ticket, failureDescription(failureStage, shadowFailure));
+                if (isSourceChanged(shadowFailure)) {
+                    // SQL 51025 is the stored procedure's optimistic-concurrency guard:
+                    // source rows changed while the snapshot was being built. Treat it as
+                    // a stale refresh and defer the next attempt; retrying immediately only
+                    // creates another collision and incorrectly reports an application error.
+                    metrics.increment(ShadowSkipReason.STALE);
+                    recoveryNotBefore.set(clock.instant().plus(RECOVERY_COOLDOWN));
+                    LOG.info("shadow_refresh_stale warehouse={} snapshotGeneration={} sqlCode=51025",
+                            warehouseId, generation);
+                    return;
+                }
                 metrics.recordError(failureStage);
                 warnFailure("CONTROL", generation, failureStage, shadowFailure, startedNanos);
             }
@@ -290,6 +301,21 @@ public class ShadowObservationGateway {
         recoveryNotBefore.set(clock.instant().plus(RECOVERY_COOLDOWN));
     }
 
+    private boolean isSourceChanged(Throwable failure) {
+        Throwable cause = failure;
+        for (int depth = 0; depth < 8 && cause != null; depth++) {
+            if (cause instanceof SQLException sql && sql.getErrorCode() == 51025) {
+                return true;
+            }
+            Throwable next = cause.getCause();
+            if (next == cause) {
+                break;
+            }
+            cause = next;
+        }
+        return false;
+    }
+
     private Optional<ShadowSnapshotCoordinator.RefreshTicket> tryBeginRefreshAfterQuietWindow()
             throws InterruptedException {
         if (coordinator.activeLegacyCount() != 0) {