From 5dfb3002ea64f9be0bb66d3df1fe1849a6f5ba57 Mon Sep 17 00:00:00 2001
From: chelsealong <chelsealong@126.com>
Date: Sun, 9 Aug 2026 01:18:48 +0000
Subject: [PATCH] Fix --disable-mmap not bypassing safetensors mmap read

load_torch_file only wrapped the tensor returned by
safetensors.safe_open()/get_tensor() in a copy when --disable-mmap was
set; the mmap-backed read that produces that tensor had already
happened by then. On Windows that mmap-backed read of large
safetensors files can crash the long-running ComfyUI process with an
access violation (#15424). --disable-mmap now reads tensors with plain
file I/O so no mmap of the file is created at all.
---
 comfy/utils.py                                | 34 ++++++++++++++++---
 tests-unit/comfy_test/load_torch_file_test.py | 32 +++++++++++++++++
 2 files changed, 62 insertions(+), 4 deletions(-)
 create mode 100644 tests-unit/comfy_test/load_torch_file_test.py

diff --git a/comfy/utils.py b/comfy/utils.py
index 61c2a22dd..b159844c9 100644
--- a/comfy/utils.py
+++ b/comfy/utils.py
@@ -119,6 +119,31 @@ def load_safetensors(ckpt):
     return sd, header.get("__metadata__", {}),
 
 
+def load_safetensors_no_mmap(ckpt, device):
+    # safetensors.safe_open()/get_tensor() reads tensor data through an mmap of
+    # the file. On Windows that mmap-backed read can crash with an access
+    # violation for large files in a long-running process. Read the tensors
+    # with plain file I/O instead so no mmap of the file is ever created.
+    sd = {}
+    with open(ckpt, "rb") as f:
+        header_size = struct.unpack("<Q", f.read(8))[0]
+        header = json.loads(f.read(header_size).decode("utf-8"))
+        data_start = 8 + header_size
+        for name, info in header.items():
+            if name == "__metadata__":
+                continue
+            start, end = info["data_offsets"]
+            dtype = _TYPES[info["dtype"]]
+            shape = info["shape"]
+            if start == end:
+                sd[name] = torch.empty(shape, dtype=dtype, device=device)
+                continue
+            f.seek(data_start + start)
+            raw = f.read(end - start)
+            sd[name] = torch.frombuffer(bytearray(raw), dtype=dtype).view(shape).to(device=device)
+    return sd, header.get("__metadata__", {})
+
+
 def load_torch_file(ckpt, safe_load=False, device=None, return_metadata=False):
     if device is None:
         device = torch.device("cpu")
@@ -129,14 +154,15 @@ def load_torch_file(ckpt, safe_load=False, device=None, return_metadata=False):
                 sd, metadata = load_safetensors(ckpt)
                 if not return_metadata:
                     metadata = None
+            elif DISABLE_MMAP:
+                sd, metadata = load_safetensors_no_mmap(ckpt, device)
+                if not return_metadata:
+                    metadata = None
             else:
                 with safetensors.safe_open(ckpt, framework="pt", device=device.type) as f:
                     sd = {}
                     for k in f.keys():
-                        tensor = f.get_tensor(k)
-                        if DISABLE_MMAP:  # TODO: Not sure if this is the best way to bypass the mmap issues
-                            tensor = tensor.to(device=device, copy=True)
-                        sd[k] = tensor
+                        sd[k] = f.get_tensor(k)
                     if return_metadata:
                         metadata = f.metadata()
         except Exception as e:
diff --git a/tests-unit/comfy_test/load_torch_file_test.py b/tests-unit/comfy_test/load_torch_file_test.py
new file mode 100644
index 000000000..b220f8f6a
--- /dev/null
+++ b/tests-unit/comfy_test/load_torch_file_test.py
@@ -0,0 +1,32 @@
+import os
+import tempfile
+
+import pytest
+import safetensors.torch
+import torch
+
+import comfy.utils
+
+
+@pytest.fixture
+def safetensors_file():
+    tensors = {"weight": torch.arange(12, dtype=torch.float32).reshape(3, 4)}
+    with tempfile.TemporaryDirectory() as tmpdirname:
+        path = os.path.join(tmpdirname, "model.safetensors")
+        safetensors.torch.save_file(tensors, path, metadata={"format": "pt"})
+        yield path, tensors
+
+
+def test_disable_mmap_does_not_use_safe_open(safetensors_file, monkeypatch):
+    path, tensors = safetensors_file
+    monkeypatch.setattr(comfy.utils, "DISABLE_MMAP", True)
+
+    def boom(*args, **kwargs):
+        raise AssertionError("safetensors.safe_open should not be used when DISABLE_MMAP is set")
+
+    monkeypatch.setattr(comfy.utils.safetensors, "safe_open", boom)
+
+    sd, metadata = comfy.utils.load_torch_file(path, device=torch.device("cpu"), return_metadata=True)
+
+    assert torch.equal(sd["weight"], tensors["weight"])
+    assert metadata == {"format": "pt"}