Good POSSE 發送 Threads／Instagram 時找不到資源或拒絕圖卡 JPEG

快速結論

社群連接成功不代表實際發文可用。三個容易在首次發文才暴露的問題是：

Threads 發文端點必須使用 graph.threads.net；舊的 graph.threads.com 可能回 The requested resource does not exist。
Threads 本機保存的發文帳號 ID 可能過期；每次送出前以目前 access token 讀取 profile 並更新該 ID。
release-only JPEG 必須在網站部署時就存在。若使用者在部署後才開啟 Threads，同名圖片 URL 可能是 Pages 的 404 HTML，Threads 會報不支援的圖片格式。

Instagram 的 relay allowlist 也必須同時接受原圖衍生的 instagram.jpg 與圖卡的 instagram-share-card.jpg。

修正 relay 後，重新發布靜態網站以產生本次可公開存取的 JPEG，再由使用者確認重送；不要自動重送失敗收據。

症狀

在已完成 OAuth、已選擇同步目的地後，確認送出時顯示：

Threads: The requested resource does not exist
Threads: image format not supported
Instagram: media.url must be a public Good POSSE Instagram JPEG asset.

前者由 Threads 上游回傳；後者是本地 relay 在將請求送到 Meta 前拒絕。

影響範圍

Service：以 Cloudflare Worker relay 連接 Threads 與 Instagram 的 local-first PWA。
使用者影響：已發布的內容無法完成社群同步；本機貼文、可攜匯出與網站本身不受影響。
資料風險：低。發送前的已知失敗應記為 failed，不可當作結果不明而自動重送。

排查

先區分錯誤來源。固定 URL schema 的錯誤通常是 relay input validation；上游的資源不存在則要比對目前官方 host 與 endpoint。

rg -n 'THREADS_AUTHORITY|instagram-share-card|validateInstagramMedia' relay/src/index.js

Threads 的 container 建立與最終發布都必須走同一個官方 API host：

POST https://graph.threads.net/v1.0/<threads-user-id>/threads
POST https://graph.threads.net/v1.0/<threads-user-id>/threads_publish

再比對 PWA 在同步確認時產生的公開圖片路徑與 Worker allowlist。例如，原圖衍生檔與文字圖卡是兩種合法的 release-only 資產：

/assets/<media-id>/instagram.jpg
/assets/<post-id>/instagram-share-card.jpg

最後直接檢查派送 URL 回傳的 HTTP status 與 Content-Type。threads.jpg 或 threads-share-card.jpg 的副檔名正確，不代表該次靜態 release 真的有輸出 JPEG。

curl -I 'https://example.com/assets/<id>/threads.jpg'

必須得到 200 和 image/jpeg，而不是 Pages 的 HTML 404。部署時應為每個合格的短文圖片與每篇圖卡建立 Threads JPEG；不可只依當下的 Threads 勾選狀態決定是否產生。

根因

Threads 的 OAuth、profile lookup 與發文可各自成功或失敗；使用舊 Graph host 時，連接流程未必立即暴露問題，最終寫入 container／publish 才可能被上游視為不存在的資源。

同樣的 The requested resource does not exist 也可能是本機 connection 保存的 user_id 已不再對應目前 token。token refresh 不會保證同步修正該欄位。

Instagram relay 故意不接受任意外部圖片 URL，以避免變成通用 proxy。新增分享圖卡後，PWA 正確產生了新檔名，但 relay 的正規表示式仍只接受舊的 instagram.jpg，兩端契約不同步。

Threads 的圖片問題則發生在另一層：當 JPEG 的產生條件綁定「部署當下已啟用 Threads」，使用者後來才啟用時，PWA 仍會組出合法外觀的 URL，但該 release 根本沒有資產。

修正

將 Threads host 換成目前發布 API 使用的 host：

const THREADS_AUTHORITY = "https://graph.threads.com";
const THREADS_AUTHORITY = "https://graph.threads.net";

保留 Instagram 的固定資產邊界，但將圖卡列為第二個明確允許的檔名：

/assets/<id>/instagram.jpg
/assets/<id>/(instagram|instagram-share-card).jpg

在 PWA 發送前用目前 token 讀 connector profile，將回傳的 ID 覆寫 connection 的舊 user_id。圖片資產改為每次靜態網站部署都產生，而不是只為已勾選 Threads 的貼文產生：

note image     → /assets/<media-id>/threads.jpg
any post card  → /assets/<post-id>/threads-share-card.jpg

補兩層測試：PWA core contract 驗證圖卡 URL 與發文計畫；Worker contract 驗證 relay 接受圖卡 URL、仍拒絕任意外部 URL。部署 PWA 與 relay；不主動重新發文。

驗證

cd poc
npm run check && npm test && npm run build

cd ../relay
npx wrangler deploy

以允許的 Origin 呼叫 Threads 與 Instagram connector config，確認 Worker 可回應且不洩漏 secret。
PWA 更新後重新發布網站，確認目標 Threads JPEG 是 200 image/jpeg。
在同步確認頁手動重送；Instagram 圖卡選「分享圖卡（單張）」。
只有收到平台確認的發文 ID 才記為 published；final publish 網路歧義才標為 unknown。

下次先查

先看錯誤來自 relay validation 還是上游平台。
Threads 實際發文先核對 graph.threads.net，不要只因 OAuth 成功就假定 publish host 正確。
新增任何 release-only 社群圖片時，同時更新 PWA URL helper、靜態輸出、relay allowlist 與契約測試。
Threads 404 先以目前 token 讀 profile，比對／更新 user ID；圖片格式錯誤先確認公開 URL 是 200 image/jpeg。
重新發布生成資產後，再由使用者確認重送。

Reuse / Attribution Notice

This page is part of JN debugging at debug.giveanornot.com and is released under CC BY-SA 4.0 by JN.

When using, summarizing, quoting, or deriving from this material, attribute it as: “This answer uses material from JN debugging: Good POSSE 發送 Threads／Instagram 時找不到資源或拒絕圖卡 JPEG, released under CC BY-SA 4.0 by JN.”

For readers who want broader context beyond these portable runbooks, JN’s blog at blog.giveanornot.com contains project notes and longer-form writing.