前幾天已經陸續完成 AI 避雷探針的主要功能，包括店家搜尋、評論取得、Gemini AI 分析、會員登入、歷史紀錄、報告更新以及 PDF 下載。
前面的開發都是在自己的電腦上使用 localhost 進行測試。
所以今天決定進入下一個階段：
把網站正式部署到線上。
原本以為只要把網站部署到 Firebase Hosting，之後就可以直接使用。
沒想到網站成功上線後，第一個遇到的問題不是網頁跑版，而是：

Gemini AI 分析突然不能正常使用了。
這也讓我第一次真正遇到「本地端可以運作，但部署到正式環境後卻出現問題」的情況。

一、先把網站部署到 Firebase

首先，我先將目前完成的網站部署到 Firebase Hosting。
原本在本機測試時，網站是透過localhost開啟。
部署後則可以透過 Firebase 提供的網站網址進行操作。

【實際操作圖 1：Firebase Hosting 部署成功】

從部署結果來看，網站本身是可以正常開啟的。
首頁、CSS、JavaScript 等基本內容也都有正常載入。
看到這裡原本以為今天的部署應該已經完成了。
但實際操作後，才發現問題出現了。

二、網站可以開，但 Gemini 無法正常分析

我先測試最重要的功能：

搜尋店家 → 取得評論 → 開始 AI 分析

在 localhost 測試時，這個流程原本是可以正常執行的。
但是部署到 Firebase 後，店家搜尋等功能可以使用，到了 Gemini AI 分析這一步卻出現問題。
也就是：
網站本身可以正常開啟，但 Gemini AI 分析功能無法正常運作。
【實際操作圖 2：部署後沒跑Gemini】

這時候才發現，網站部署並不是單純把 HTML、CSS、JavaScript 放到網路上而已。
只要網站裡面還有 API、登入、資料庫等服務，部署後就可能需要重新確認相關設定。

三、為什麼 localhost 可以，部署後卻不行？

這次遇到的問題讓我開始思考：

「明明程式碼是一樣的，為什麼本地端可以，放到線上卻不能？」
因為 localhost 和正式網站的執行環境並不完全相同。
在本地端測試時，可能會使用：

localhost

但部署後，網站變成：

Firebase Hosting 網域

如果 API Key、網域限制、環境變數或 API 設定有依賴本地環境，就可能造成部署後無法正常使用。
所以我開始從幾個方向檢查。

四、開始檢查 Gemini API 設定

第一個檢查的是 Gemini API。
因為目前 AI 避雷探針的核心功能就是：

Google Maps 評論 → Gemini → AI 避雷報告
所以只要 Gemini API 無法使用，網站最重要的功能之一就會失效。
我開始檢查：

• Gemini API Key 是否正確
• API Key 是否可以正常使用
• API Key 是否有設定網域限制
• Firebase 部署後是否能正常取得 API Key
• JavaScript 是否有正確執行 Gemini API
• 瀏覽器 Console 是否出現錯誤
• Network 是否有成功送出 API Request

【實際操作圖 3：瀏覽器 Console／錯誤訊息】

這時候我也發現，不能只看網站畫面判斷問題。
因為畫面可能看起來完全正常，但真正的錯誤可能藏在瀏覽器的 Console 或 Network 裡。

五、部署後才發現「可以開啟」不代表「全部功能正常」

這次的經驗讓我很明顯感受到：
網站成功部署，不代表網站已經完成。
如果只測試：

網址可以開啟 → OK
其實是不夠的。
還需要實際測試網站功能
每一個功能都有可能因為正式環境不同而出現問題。
所以部署後的測試其實也是開發流程的一部分。

六、目前的處理方式

今天先確認了問題出現在：

Firebase 部署後，Gemini AI 分析無法正常使用。
接著開始從 API Key、Firebase Hosting、網域設定以及瀏覽器錯誤訊息等方向進行排查。
目前並不是單純把錯誤訊息消掉，而是希望找到真正的原因。
因為如果只是暫時讓它可以執行，之後重新部署或更換環境時，問題可能還是會再次出現。
【實際操作圖 4：目前線上版網站】

七、今天收穫

今天原本以為只是單純的「網站部署」，結果實際操作後才發現，部署其實是另一個階段的測試。
以前在 localhost 開發時，只要程式可以正常執行，就會覺得功能完成了。
但今天把網站放到正式環境後才發現：
本地端可以跑，不代表正式環境也一定可以跑。
尤其我的網站還有 Gemini API、Firebase Authentication、Firestore 等服務，不同服務之間的設定都可能影響網站最後能不能正常運作。
這次 Gemini 的問題雖然讓原本預計的進度被打亂，但也讓我第一次真正遇到部署環境的問題。
比起直接把網站部署成功，我覺得今天更重要的是學會：

遇到問題 → 查看錯誤 → 找出可能原因 → 一步一步排查。