In case of misconfiguration of dataset.encoding unlimited_dims warn instead of raise

xarray/backends/api.py

@@ -262,7 +262,10 @@ def _sanitize_unlimited_dims(dataset, unlimited_dims):
                 f"but not part of current dataset dimensions. "
                 f"Consider removing {undeclared_dims!r} from {msg_origin!r}."
             )
-            raise ValueError(msg)
+            if msg_origin == "unlimited_dims-kwarg":
+                raise ValueError(msg)
+            else:
+                emit_user_level_warning(msg)
         return unlimited_dims
 
 

xarray/tests/test_backends.py

@@ -1399,8 +1399,8 @@ def test_encoding_unlimited_dims(self) -> None:
         # test unlimited_dims validation
         # https://github.com/pydata/xarray/issues/10549
         ds.encoding = {"unlimited_dims": "z"}
-        with pytest.raises(
-            ValueError,
+        with pytest.warns(
+            UserWarning,
             match=r"Unlimited dimension\(s\) .* declared in 'dataset.encoding'",
         ):
             with self.roundtrip(ds) as _: