Skip to content

Custom node import failures only show “IMPORT FAILED” with no error context #11454

@cmyoussef

Description

@cmyoussef

Custom Node Testing

Expected Behavior

When a custom node fails to import, ComfyUI should report why the import
failed (at least the exception type and message) in the import summary.

Example:
(IMPORT FAILED: ModuleNotFoundError: No module named 'xyz')

The full traceback can still be logged for deeper debugging.

Actual Behavior

When a custom node fails to import, the “Import times for custom nodes”
section only shows:

(IMPORT FAILED)

No exception type or error message is shown next to the failing module.
This makes diagnosing broken custom nodes difficult, especially when
many nodes are loading.

Steps to Reproduce

  1. Start ComfyUI with at least one custom node that fails to import
    (e.g. missing dependency, syntax error, invalid import).

  2. Launch ComfyUI normally.

  3. Observe the startup logs under:

    “Import times for custom nodes”

  4. Note that the failing node only reports:
    (IMPORT FAILED)
    with no error context.

Debug Logs

Import times for custom nodes:
   0.0 seconds: %USER\@comfyorgcomfyui-electron\resources\ComfyUI\custom_nodes\websocket_image_save.py
   0.0 seconds (IMPORT FAILED): %PKG\custom_nodes\comfy_remote_workflow_saver
   0.0 seconds: %PKG\custom_nodes\comfy_remote_dispatcher

Other

This is a diagnostics / UX bug rather than a feature request.

The exception already exists internally but is not surfaced in the import
summary, forcing users to manually correlate failures with log output.

I’ve attached a small, surgical patch that:

  • Captures the exception raised during custom node import
  • Displays a concise one-line failure reason inline
  • Logs the full traceback once for immediate diagnosis

If maintainers are okay with the approach, I’m happy to open a PR.

custom_node_import_diagnostics.patch

After the fix it will look like this

0.0 seconds (IMPORT FAILED: ImportError: attempted relative import beyond top-level package):
custom_nodes/comfy_remote_io

Custom node import traceback for custom_nodes/comfy_remote_io:
Traceback (most recent call last):
  File "nodes.py", line 2155, in load_custom_node
    module_spec.loader.exec_module(module)
  File "custom_nodes/comfy_remote_io/__init__.py", line 2, in <module>
    from .nodes.cremote_image_loader import CREMOTE_ImageLoader, CREMOTE_LiveImage
  File "custom_nodes/comfy_remote_io/nodes/cremote_image_loader.py", line 14, in <module>
    from ...utils.color import list_ocio_colorspaces
ImportError: attempted relative import beyond top-level package

Metadata

Metadata

Assignees

No one assigned

    Labels

    FrontendIssue relates to the frontend UI (litegraph).Potential BugUser is reporting a bug. This should be tested.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions