OpenGL dependencies not available in ComfyUI

如果 ComfyUI 日誌裡出現 OpenGL dependencies not available，說明內置 GLSL shader 節點的導入時依賴檢查沒有通過。

這次真實實驗裡，它沒有把整個 server 打死。ComfyUI 還是能打開，但 nodes_glsl.py 直到 PyOpenGL 和 glfw 都裝進同一個 Python 環境後才恢復。

.\python_embeded\python.exe -s -m pip show PyOpenGL glfw
.\python_embeded\python.exe -s -m pip install PyOpenGL
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build

.\python_embeded\python.exe -s -m pip install glfw

真實日誌長什麼樣

這次實驗裡，關鍵日誌是：

RuntimeError: OpenGL dependencies not available.
Cannot import ...\ComfyUI\comfy_extras\nodes_glsl.py module for custom nodes: OpenGL dependencies not available.

nodes_glsl.py 這段內置代碼會檢查兩個 Python 包：

• glfw
• 來自 PyOpenGL 的 OpenGL

只要缺一個，GLSL 節點就不會回來。

快速判斷

第 1 步：先看本地 requirements

實驗環境裡的 ComfyUI\requirements.txt 包含：

PyOpenGL
glfw

你自己的環境先查：

Get-Content ComfyUI\requirements.txt | Select-String "PyOpenGL|glfw"

第 2 步：一個包一次修

Windows 便攜包：

.\python_embeded\python.exe -s -m pip install PyOpenGL

然後重啟一次看日誌。真實實驗裡，這一步還不夠，OpenGL 錯誤還在，所以接著裝了：

.\python_embeded\python.exe -s -m pip install glfw

這也是這篇單獨拆出來的價值：只看到錯誤字符串還不夠，你還得知道它背後實際上是“兩件套”，缺任意一半都不行。

第 3 步：重啟，驗證 GLSL 節點回來

重新啟動：

.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build

這次實驗裡：

• 只裝 PyOpenGL 後，OpenGL 錯誤還在
• 再裝 glfw 後，錯誤才消失
• /object_info 節點數從 687 增加到 688

最後這個節點數變化，是很直接的恢復信號。

第 4 步：理解它到底影響多大

這個錯誤通常意味著：

• 服務本身還能啟動
• 其他節點可能還能工作
• 但 GLSL shader 節點不可用

所以它是真問題，但不是 torch、sqlalchemy 那種“服務根本起不來”的問題。

如果你的工作流需要 GLSL 節點，那它依然很急；如果不需要，那你可以把它當作“內置 extra 節點修復”，而不是“整個 ComfyUI 全掛了”。

不要做這些事

• 不要以為裝了 PyOpenGL 一定就修好
• 不要把包裝到系統 Python，而 ComfyUI 其實跑在 python_embeded 或 venv
• 不要把 Windows 上缺包的情況和 Linux 無顯示環境的問題混為一談
• 不要只看瀏覽器能打開，就忽略 GLSL 節點其實還沒恢復

Wonderful Launcher 能幫什麼

這又是一個“ComfyUI 能打開不等於節點面完整”的例子。Wonderful Launcher 更適合這種情況，因為它能幫助你驗證：修復之後，預期節點是不是真的回來了，而不只是網頁能不能訪問。

相關指南

• ComfyUI 便攜版依賴損壞後，按一個報錯一個包修啟動
• ModuleNotFoundError: No module named 'kornia' in ComfyUI
• ComfyUI No module named 警告：什麼時候可以忽略
• ComfyUI Startup Failed
• ComfyUI 依賴衝突

來源與實測

• 2026-05-18 Windows 便攜版實驗：OpenGL dependencies not available 讓 ComfyUI\comfy_extras\nodes_glsl.py 導入失敗
• 同一實驗 ComfyUI\requirements.txt：包含 PyOpenGL 和 glfw
• 同一實驗驗證：只裝 PyOpenGL 還不夠，補上 glfw 後 GLSL 節點恢復，/object_info 節點數從 687 增加到 688