📌 7️⃣ 常見問題與最佳實踐

🎯 Gradio 開發與部署時的常見問題

在使用 Gradio 開發應用時，可能會遇到一些問題，以下是常見的錯誤與解決方案。

❌ 問題 1：Gradio 介面無法啟動，出現 `OSError: [Errno 98] Address already in use`

✅ 原因：預設的 7860 埠 已經被其他程式佔用。

✅ 解決方法： 1. 關閉已佔用該埠的應用程式

lsof -i :7860  # 在 Linux/macOS 上檢查佔用 7860 埠的程式
kill -9 <PID>  # 終止該程式

2. 指定新的埠號（例如 8080）：

gr.Interface(fn=my_function, inputs="text", outputs="text").launch(server_port=8080)

❌ 問題 2：Gradio 頁面空白，無法載入介面

✅ 原因：可能是 瀏覽器快取問題 或 Gradio 更新後的 API 變更。

✅ 解決方法： - 清除瀏覽器快取，重新整理頁面。 - 更新 Gradio 到最新版本

pip install --upgrade gradio

- 檢查 launch() 是否有 server_name="0.0.0.0"（特別是在伺服器上運行時）

gr.Interface(fn=my_function, inputs="text", outputs="text").launch(server_name="0.0.0.0")

❌ 問題 3：`ModuleNotFoundError: No module named 'gradio'`

✅ 原因：Python 環境中 沒有安裝 Gradio，或安裝在錯誤的環境中。

✅ 解決方法： 1. 確保 Gradio 已安裝：

pip install gradio

2. 如果使用 Jupyter Notebook，請先安裝並重新啟動 Kernel：

!pip install gradio

3. 檢查 Python 環境是否正確（適用於 Conda）：

conda activate my_env  # 切換到你的環境
pip install gradio  # 在該環境內安裝

🎯 Gradio 開發的最佳實踐

✅ 1. 使用 `Blocks API` 建立複雜應用

如果你的應用包含 多個輸入、輸出，或有 按鈕點擊觸發的動作，建議使用 gr.Blocks()。

import gradio as gr

def greet(name):
    return f"Hello, {name}!"

with gr.Blocks() as demo:
    textbox = gr.Textbox(label="輸入你的名字")
    button = gr.Button("提交")
    output = gr.Textbox(label="輸出結果")

    button.click(fn=greet, inputs=textbox, outputs=output)

demo.launch()

✅ 使用 Blocks 可以更靈活地自訂 UI，適合較大型的應用。

✅ 2. 減少記憶體消耗（避免 GPU 過載）

如果你的應用運行 大型機器學習模型，請考慮以下技巧： - 使用 queue=True 避免高併發請求導致崩潰。

gr.Interface(fn=my_model, inputs="text", outputs="text").launch(queue=True)

- 釋放未使用的記憶體（適用於 PyTorch / TensorFlow）

import torch
torch.cuda.empty_cache()  # 清理 GPU 記憶體

- 限制請求的數量

gr.Interface(fn=my_model, inputs="text", outputs="text", max_queue_size=5).launch()

✅ 這些方法可以提升伺服器穩定性，減少過載風險。

✅ 3. 使用 `gr.update()` 動態更新元件

有時候你可能需要 根據使用者輸入動態修改 UI，可以使用 gr.update()。

import gradio as gr

def update_interface(value):
    if value == "開啟":
        return gr.Textbox(visible=True)
    else:
        return gr.Textbox(visible=False)

with gr.Blocks() as demo:
    dropdown = gr.Dropdown(["開啟", "關閉"], label="選擇選項")
    textbox = gr.Textbox(label="這是輸入框", visible=False)
    dropdown.change(update_interface, inputs=dropdown, outputs=textbox)

demo.launch()

✅ 這可以根據使用者選擇，動態顯示或隱藏 UI 元件。

📌 總結

問題/技巧	解決方法
介面無法啟動	確保埠號未被佔用，或改用 `server_port=8080`
頁面空白	清除瀏覽器快取，更新 Gradio，設定 `server_name="0.0.0.0"`
`ModuleNotFoundError`	確保在正確的 Python 環境內安裝 Gradio
記憶體過載	使用 `queue=True`，釋放 GPU 記憶體
動態更新 UI	使用 `gr.update()` 調整元件顯示狀態

🚀 恭喜你完成了 Gradio 教學！現在你已經具備使用 Gradio 開發、部署、最佳化的完整知識！ 🎉😊