Notion 小工具無法載入?
先找出問題原因。

空白區塊、登入提示及被裁切的小工具,乍看可能是同一個問題,但原因並不相同。重新建立儀表板之前,請先使用這份檢查清單找出癥結。

先確認 小工具的正確 URL 、出現問題的裝置和應用程式,以及小工具是否仍能在獨立的瀏覽器分頁運作。本指南會區分 Notion 的嵌入行為,以及外部小工具對主機、帳戶、API、瀏覽器和儲存空間的要求。這是故障診斷的方法,而不是宣稱 Saif Saber Studio 某個特定小工具已經損壞。

三分鐘排查:你實際看到了什麼?

  • 空白框架或 Failed to Load: 首先確認 URL 正確,以及來源網站是否允許嵌入。不要認為清除快取就能繞過 iframe 政策。
  • 登入畫面: 檢查來源是否需要登入外部服務,以及目前的 Notion 應用程式是否支援這種登入方式。
  • 框架正常顯示但沒有資料: 檢查小工具所需的網路、API、權限或輸入參數。
  • 顯示設定畫面或 Start 按鈕: 這可能是預期設計,而不是載入失敗。例如目前的 Flag Quiz 必須先按 Start quiz,才會開始題目或計時器。
  • 小工具內容遭到裁切: 增加區塊的寬度與高度,然後使用相同的 URL 再測試一次。
  • 進度重設或消失: 檢查小工具是否將狀態儲存在瀏覽器,而不是 Notion 頁面。

請分別記錄 Notion 網頁版、桌面版與行動版的測試結果。一般網站的 iframe 成功運作,不代表同一個小工具也能在 Notion 應用程式中運作。

試用 Flag Quiz

開啟 Flag Quiz

1. 檢查嵌入時使用的正確 URL

  1. 開啟來源小工具的詳細資訊或自訂設定頁面,若有專用的嵌入或分享網址,請複製該 URL。
  2. 確認 URL 以 https:// 開頭,而且沒有輸入錯誤。不要將原始的 <iframe> HTML 程式碼貼入 Embed 區塊的 URL 欄位。
  3. 在 Notion 中建立 Embed 區塊,可以使用 /embed 指令或新增區塊選單,再貼上 URL。如果先前選擇的是書籤或連結,請先確認區塊類型,再判斷小工具是否故障。
  4. 在新的瀏覽器分頁中測試直接連結。排查時,請在嵌入內容旁保留一般的來源連結。

Notion 的 官方嵌入說明文件 說明了 Embed 區塊、URL 輸入、尺寸調整,以及某些來源網站可能禁止嵌入的情況。Notion 的選單名稱可能改變,發佈螢幕截圖前請在目前的應用程式中確認。

2. 小工具在自己的網站能正常運作嗎?

如果來源頁面本身無法載入,Notion 區塊也無法可靠地修復它。請檢查網址、網路連線、來源主機是否正常,以及瀏覽器擴充功能或網路過濾器是否阻擋必要資源。如果直接開啟可以運作,請與嵌入版本比較 在相同裝置和網路下 ,以判斷問題是否只發生在嵌入環境。

每次只更動一個變數並記錄結果。確定狀態是否儲存在瀏覽器本機之前,請避免清除資料或刪除儀表板。

3. 來源網站是否允許嵌入?

網站可能可以在獨立分頁正常開啟,卻拒絕顯示在另一個網站內。相關的嵌入政策由來源網站擁有者控制,Notion 也有自己的嵌入處理方式。如果框架提示限制,請使用供應商支援的連結或官方整合方式,不要試圖繞過限制。

Notion 明確提醒,某些網站禁止嵌入,並可能顯示 Failed to Load 錯誤。這只是文件中提到的一種可能性,不能直接認定所有空白框架都是這個原因。

4. 是否需要另外登入?

根據 Notion 的嵌入說明,需要登入外部網站的嵌入內容無法在 Notion 桌面或行動應用程式中運作。因此,在已登入的瀏覽器中可以預覽,不代表原生應用程式也相容。

如果外部服務提供獲授權的分享方式或公開檢視選項,可以使用這些功能;否則保留一般連結。不要只為了讓嵌入顯示,就公開帳戶、私人文件、API 權杖或服務金鑰。請遵守來源網站的存取權限。

5. 框架已載入,但資料或控制項未顯示

小工具可能依賴即時天氣、匯率、社群平台介面、第三方媒體、裝置位置或其他外部服務。如果框架出現了,但資料遺失或過時,請檢查輸入值、權限與相關服務的官方狀態。網路存取、速率限制、供應商變更和瀏覽器限制,可能對實際功能造成不同於靜態介面的影響。

不要將沒有權限限制的 API 金鑰放在公開的嵌入 URL 中。 URL 參數可能被複製、分享或記錄。如果小工具需要機密資料,請先停止排查並審查實際的安全模型。

簡單的比較方式是,拿一個無須登入、外部依賴較少的小工具與發生問題的小工具進行測試。一個嵌入成功只能證明區塊可能正常運作,不能代表所有第三方服務都相容。

6. 小工具是否只是太小或遭到裁切?

  1. 將滑鼠游標移至 Notion 的 Embed 區塊,利用可用的側邊控制點增加寬度,也檢查垂直空間和周圍欄位。
  2. 認定控制項消失之前,先在全寬欄位中測試相同的來源。
  3. 在較窄的手機螢幕上測試,確保不使用滑鼠也能操作按鈕。
  4. 對互動式內容,請測試 Tab 和 Shift+Tab 導覽及離開 iframe 的方式。如果焦點被困住,在確認之前應優先使用一般連結。

Notion 提供嵌入內容尺寸調整及欄位配置的說明。控制點的外觀因平台而異,觸控裝置也可能有不同的操作方式。放大框架並不能解除來源網站的限制或補回遺失的網路資料。

7. 小工具的設定或進度是否遺失?

並非每個小工具都把資料儲存在 Notion 資料庫中。有些使用瀏覽器本機儲存空間或工作階段狀態,可能在 iframe 中相互隔離、被隱私設定清除,或因瀏覽器和裝置而不同。小工具即使顯示在 Notion 中,也不代表內部狀態會與工作區同步。

重設瀏覽器、清除儲存空間或複製頁面之前,請先確認小工具實際支援的儲存與匯出功能。例如,Focus Scoreboard 會讀取 Pomodoro Timer 的瀏覽器本機紀錄,其中只有自然完成的專注階段,不包含略過的時段;重設歷史紀錄時,也會刪除對應的共用計時器紀錄。請先匯出 Full History JSON 備份。如果兩個嵌入內容顯示不同結果,請檢查它們是否能存取小工具主機上相同的儲存環境。Notion 不會同步這些紀錄。未經實測,不應承諾跨裝置同步。

選擇安全的下一步

  • URL 錯誤: 將 Embed 區塊改為供應商提供的正確 URL。
  • 來源無法使用: 檢查來源服務或等待其官方支援的復原程序,並保留一般連結。
  • 嵌入遭到封鎖: 使用連結、書籤或官方支援的整合方式,而不是繞過 iframe 限制。
  • 需要外部登入: 尤其是在 Notion 桌面與行動應用程式中,優先使用獲授權的公開檢視或直接連結。
  • 框架太小或內容遭到裁切: 調整尺寸或欄位,然後重新測試。
  • 儲存狀態遺失: 刪除任何資料前,先檢查本機儲存與匯出功能。

如果問題持續存在,請記下不含機密資訊的小工具 URL、Notion 平台、瀏覽器或應用程式版本、直接開啟時的情況、顯示的錯誤訊息與已嘗試的步驟。這樣可以在不洩漏登入憑證的情況下提出可重現的錯誤報告。

常見問題

為何小工具在 Chrome 可以運作,卻無法在 Notion 桌面應用程式中使用?

嵌入環境可能不同。外部登入限制、瀏覽器儲存空間及權限處理都可能影響結果。請在各平台比較相同的小工具、URL 與登入狀態,不要預設只有一種修復方式。

可以把 iframe HTML 程式碼直接貼入 Notion 嗎?

Notion 的 Embed 區塊需要來源 URL 或嵌入連結,而不是原始的 iframe HTML 標籤。請使用供應商指定的 HTTPS 連結和區塊的 Embed 選項。

將 Notion 頁面公開就能修復小工具嗎?

不一定。頁面公開不會覆蓋來源網站的嵌入政策、外部服務的權限,也不會取消小工具對 API 和儲存空間的要求。

嵌入的計時器或追蹤工具會同步到我的 Notion 資料庫嗎?

僅僅嵌入不會建立與 Notion 資料庫的整合。在依賴小工具儲存重要紀錄之前,請確認它實際支援的儲存與整合功能。