ComfyUI v0.14.2 發布：修復 Gemini/Nano banana 節點空白圖像問題，全新 MIME 匹配機制登場

一、版本綜述

2026年2月18日，ComfyUI 官方發布了最新穩定版本v0.14.2。這一版本屬于不可變版本（Immutable release），意味著除了版本標題和說明外，其他部分將不會再修改。相較前一版 v0.14.1，本次更新雖然是一個“小版本”迭代，但其影響卻相當關鍵 —— 它針對Gemini/Nano banana API 節點在部分情況下返回空白圖像的問題進行了修復，同時引入了更智能的MIME類型 glob 匹配機制，進一步提升了 ComfyUI 的圖像識別與節點兼容能力。

本次更新僅包含一個提交（commit），由一名貢獻者完成，在一份文件中進行了11處新增與3處刪除，核心修改集中于 comfy_api_nodes 模塊下的nodes_gemini.py文件。

二、本次更新詳細變更內容及技術解析 1. 更新目標：解決 Gemini/Nano API 空白圖像問題

在此前版本中，ComfyUI 的 API 節點在處理 Gemini 模型生成的內容時，偶爾會出現返回空白圖像的情況。這個問題主要出現在節點對返回的 MIME 類型進行匹配的過程中，系統僅能識別具體的字符串類型（如 "image/png"），而無法通配或靈活識別其他類型，例如 "image/jpeg" 或 "image/webp" 等。

此問題導致部分模型生成的圖片未能正確提取和呈現，嚴重影響使用體驗。

v0.14.2 版本針對這一問題進行了根本性的技術改進，通過使用glob（通配符）匹配機制，使 MIME 類型匹配更加靈活和智能，從而徹底解決這一潛在漏洞。

2. 代碼關鍵改動：增加_mime_matches函數

在 comfy_api_nodes/nodes_gemini.py 文件中新增了如下邏輯：

def _mime_matches(mime: GeminiMimeType | None, pattern: str) -> bool:
    """Check if a MIME type matches a pattern. Supports fnmatch globs (e.g. 'image/*')."""
    if mime is None:
        return False
    return fnmatch(mime.value, pattern)

這一函數通過引入 Python 標準庫fnmatch模塊，實現了基于通配符的 MIME 字符串匹配。
從原先的嚴格字符串等值判斷，演進為支持標準通配表達式，如：

• ?"image/*"—— 匹配所有圖像類型；

• ?"text/*"—— 匹配所有文本類型；

• ?"application/*"—— 匹配所有應用數據類型。

這樣一來，當 Gemini 模型在返回數據時使用不同的 MIME 描述（例如某些模型可能返回"image/jpeg"或"image/webp"），程序都可以自動識別并正確提取圖像數據，極大提升了兼容性與穩定性。

3. 函數get_parts_by_type改進：全面采用_mime_matches匹配機制

在此函數中，原本用于判斷 MIME 類型的邏輯為直接字符串比較：

elif part.inlineData and part.inlineData.mimeType == part_type:

新的代碼將其改為：

elif part.inlineData and _mime_matches(part.inlineData.mimeType, part_type):

同樣地，文件數據部分也采用相同邏輯：

elif part.fileData and _mime_matches(part.fileData.mimeType, part_type):

這意味著無論數據是inlineData（內嵌數據）還是fileData（文件數據），都能通過靈活的模式匹配來識別不同類型的輸入內容。

這一步調整是本次更新的核心，它直接關聯到 Gemini 節點的圖像提取邏輯，也是解決空白圖像問題的根本。

4. 函數get_image_from_response改進：支持所有圖像類型

此前版本中，程序僅從響應中提取"image/png"類型的內容：

parts = get_parts_by_type(response, "image/png")

但由于很多模型會生成多種不同格式的圖像，因此新版將其改為：

parts = get_parts_by_type(response, "image/*")

這意味著系統現在可以從返回的任何圖像類型（包括 JPEG、WEBP、GIF、TIFF 等）中識別并提取圖像數據，大幅度提升兼容性與處理效率。

這一調整配合_mime_matches函數的通配符匹配機制，可視為一次重要的底層增強，為未來擴展更多的模型支持打下了堅實基礎。

5. 本次修改的文件變化概覽

文件：comfy_api_nodes/nodes_gemini.py
變動統計：

• ?新增行數：11

• ?刪除行數：3

• ?影響模塊：Gemini/Nano banana API 節點圖像處理邏輯

• ?新增功能：支持 glob MIME 通配匹配

• ?修復問題：圖像返回空白 bug

• ?提交數量：1

這次修改雖然簡潔，但卻精準解決了核心問題——真正體現了一個成熟項目在版本迭代中“小步快跑、持續優化”的理念。

三、與上版本 v0.14.1 對比分析

為了更全面理解 v0.14.2 的意義，我們不妨簡要回顧一下 v0.14.1 的更新內容。

v0.14.1 主要更新內容：

• ? 修復 anima LLM adapter 在手動類型轉換時的前向傳播問題；

• ? 新增 “viduq3-turbo” 模型支持；

• ? 新增 Recraft V4 節點；

• ? 更新 workflow 模板至 v0.8.43。

從這些內容可以看出，v0.14.1 更注重模型層面的擴展與適配，涉及 LLM 和視頻處理模型，而 v0.14.2 則將焦點放在了API節點的穩定性與圖像數據正確性上，屬于修復與底層增強類更新。

兩者配合，使系統的功能廣度與執行可靠性同時得到提升。

四、與 v0.14.0 的歷史演進脈絡

回顧 v0.14.0 的更新，可以看出 ComfyUI 在這一系列版本中進行了多方面的技術躍遷：

• ? 動態 VRAM 管理與 Lora 模型性能優化；

• ? 3D 模型在輸出窗口中的穩定顯示；

• ? VideoSlice 節點與視頻相關模型的訓練改進；

• ? Magnific Upscaler、Bria RMBG 等節點支持；

• ? 前端版本更新至 1.38.14；

• ? 移除不再安全的舊版 PyTorch Pickle 加載；

• ? 增強對 Flux 模型、Hunyuan 視頻代碼等的適配。

在這樣一連串功能性鋪墊之后，v0.14.2 的發布顯得更具深意：
從模型到接口，再到數據格式解析，ComfyUI 已在構建一個更加統一、智能、穩健的生成式體系。

五、技術亮點與影響深度解析 1. MIME 類型通配機制的重要意義

在多模型、多媒體格式共存的今天，硬編碼的 MIME 類型早已無法滿足復雜場景需求。例如，有的生成模型會輸出 "image/png"，有的則使用 "image/jpeg" 或自定義類型如 "image/x-quickdraw"。

通過采用通配符匹配機制：

"image/*"  → 匹配所有圖片類型
"text/*"   → 匹配所有文本類型

系統可以不再關心細節具體值，而是更關注其泛型分類。這種改進不僅提升了穩定性，也為未來插件與自定義節點開發提供了更高的自由度。

2. Gemini 節點架構的可擴展性增強

Gemini 系列節點作為 ComfyUI 的一大智能接口模塊，承擔著多項內容生成任務，包括文本、圖像、文件等。不論用戶調用 Gemini 還是 Nano banana 模型，響應數據通常都包含多種 MIME 類型與數據結構。

此次更新讓 Gemini 節點在處理這些復雜的 API 響應時更加健壯，不再出現遺漏圖像或無法識別內容的情況。

3. 開發者與插件作者的直接收益

對于希望在 ComfyUI 上構建自定義節點的開發者來說，此次改動帶來的收益非常明顯：

• ? 無需擔心 MIME 類型硬編碼；

• ? 通配規則更靈活，減少兼容性問題；

• ? 節點間調用結果更穩定；

• ? API 返回圖像的識別率顯著提高；

• ? 未來可擴展更多多媒體格式處理。

雖然 v0.14.2 是一次小版本更新，但它體現了 ComfyUI 項目的生態理念：通過不斷消除細節性的技術障礙，構建一個更穩定、更可擴展的創作系統。

這一理念不僅體現在本次 MIME 匹配機制的優化，也貫穿于此前版本的每一次改進，如：

• ? 動態 VRAM 可變加載機制；

• ? 通用 Lora 支持；

• ? 多模態數據接口；

• ? 節點重試與流量控制機制。

這些都在讓 ComfyUI 從“一個工具”逐漸演進為“一個平臺”。

六、總結：從細節到體系的強化升級

ComfyUI v0.14.2 雖然只有一個 commit，卻代表了項目在穩定性與智能化方向上的持續躍進。其主要意義可歸結為以下幾點：

1. 1.修復關鍵問題：
   徹底解決 Gemini/Nano 節點返回空白圖像的 Bug。

2. 2.引入新機制：
   采用 fnmatch 通配符實現 MIME 類型泛化匹配。

3. 3.增強兼容性：
   支持所有類型的圖像數據提取，不再局限于 "image/png"。

4. 4.保持輕量穩定：
   僅一份文件、一個提交，即實現全系統底層行為優化。

5. 5.銜接歷史升級：
   與 v0.14.1、v0.14.0 連續功能演進形成完美閉環，既保持創新速度，又確保運行可控。

通過這一小步，ComfyUI 在圖像生成、API 調用、節點通信的穩定性上完成了一次實質性強化。未來版本中，這一通配機制或將被更多模塊采納，成為系統中處理多類型數據的統一策略。

七、結語

代碼地址：github.com/Comfy-Org/ComfyUI

ComfyUI v0.14.2 是一個典型的“小版本、大優化”案例。它并非推出全新功能，而是通過對底層代碼的精準補強，解決實際問題、提升通用性能，從而讓整個系統的使用體驗更自然、更可靠。

我們相信人工智能為普通人提供了一種“增強工具”，并致力于分享全方位的AI知識。在這里，您可以找到最新的AI科普文章、工具評測、提升效率的秘籍以及行業洞察。 歡迎關注“福大大架構師每日一題”，發消息可獲得面試資料，讓AI助力您的未來發展。