🐬【教學】Tibco Spotfire 無法登入？完整排查與修復指南（附重啟失敗、埠號衝突解法）

💡 前言：為什麼 Spotfire 突然登入不了？

很多工程師在開啟 Tibco Spotfire Analyst 時，會遇到這個錯誤：

「Could not connect to server 'http://127.0.0.1:82/' to download manifest」

這其實代表 Spotfire Analyst 嘗試連接伺服器失敗。更棘手的是，即使重啟 Spotfire Server，仍可能出現「無法啟動」、「埠號被占用」或「Cluster 綁定位址錯誤」等問題。

別慌，這篇文章會一步步帶你排查與修復。

---

一、判斷問題來源：不是 Analyst，而是 Server 沒啟動

首先確認 Spotfire Server 服務是否真的在執行。

1. 開啟 Windows 服務 (services.msc)
   找到「TIBCO Spotfire Server」。

2. 狀態若顯示 未啟動 或出現錯誤訊息（如 Error 1053），代表伺服器端沒起來。

3. 若正在啟動但卡住，請往下看「Cluster 綁定錯誤」。

---

二、檢查常見錯誤來源

1️⃣ 埠號被占用

Spotfire Server 預設：

• HTTP：9080

• HTTPS：9443

• Cluster (Ignite)：5703

但有些人修改為 82 或其他埠號，結果被防火牆、IIS 或其他應用佔用，導致啟動卡住。

👉 解法：
使用命令列查誰在佔用埠號（以下為安全示範）：

netstat -aon | find ":82"

再查是哪個行程：

tasklist /FI "PID eq 12345"

若不是 Spotfire 服務，請改回 9080 或 9443，或釋放該埠。

---

2️⃣ Cluster (Ignite) 綁定位址錯誤

若你在 log 中看到：

Failed to bind to any port within range [startPort=5703, portRange=0]
The configured address 'xxxxx.local' doesn't seem to resolve to this host

代表 Spotfire 的分散式叢集（Apache Ignite）無法綁定到正確的主機位址。

👉 解法：

1. 開啟 hosts 檔案（系統管理員權限）

   C:\Windows\System32\drivers\etc\hosts
   

2. 加入這一行（把主機名綁定到本機）：

   127.0.0.1  myserver.local
   

3. 確認：

   ping myserver.local
   

   應該回傳 127.0.0.1。

---

3️⃣ IPv6 導致的綁定位址問題

Spotfire 11.x 使用 Java 11，若系統同時開 IPv4/IPv6，有時會導致綁定錯亂。

👉 解法：

在 setenv.bat（位於 Spotfire Server 的 tomcat/bin 下）新增：

set "JAVA_OPTS=%JAVA_OPTS% -Djava.net.preferIPv4Stack=true"

這行指示 JVM 優先使用 IPv4。

---

4️⃣ Ignite 埠被佔用

若你要改用不同的 cluster 通訊埠（例如 5710）：

set "JAVA_OPTS=%JAVA_OPTS% -Dcom.spotfire.cluster.communication.startPort=5710"

接著重新啟動服務：

net stop "TIBCO Spotfire Server"
net start "TIBCO Spotfire Server"

---

三、Analyst 的登入網址要用哪個？

Spotfire Analyst 登入時，必須指定正確伺服器 URL。
請勿再用 http://127.0.0.1:82/，改成以下其中一個：

• ✅ https://127.0.0.1:9443/spotfire

• ✅ http://127.0.0.1:9080/spotfire（若你啟用 HTTP）

先在瀏覽器測試能否開啟登入頁，再設定進 Analyst。

---

四、完整排查流程（懶人版）

步驟	動作	說明
1	用 netstat 查埠佔用	找出 82/9080/9443/5703 是否衝突
2	hosts 綁定主機名	防止 Cluster 綁錯 IP
3	setenv.bat 加上 IPv4 參數	解決雙網卡與 IPv6 問題
4	重新啟動服務	用 net stop / net start 指令
5	Analyst 改正登入網址	不要用錯誤的 82 埠

---

五、延伸建議

• Cluster 模式部署時，每個節點都要能互相解析主機名。

• 防火牆：確保 5703、9080、9443 埠允許內部連線。

• Database：Spotfire 啟動初期若 DB 不健康，也會顯示 “UNHEALTHY → HEALTHY” 切換訊息，確認 DB 可用性。

---

✅ 結語

Spotfire 無法登入通常不是軟體壞掉，而是網路綁定或埠號衝突。
只要依序檢查：

• 主機名解析（hosts）

• 通訊埠佔用

• IPv4/IPv6 設定

• 正確的登入 URL

就能快速恢復服務、重新登入 Analyst。