> For the complete documentation index, see [llms.txt](https://help.firstline.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.firstline.cc/feature/channels/live-chat/yi-nan-za-zheng.md).

# 疑難雜症

## 無法顯示即時聊天

在某些情況下，你可能不會在網站上看到你期望的 FIRST LINE 即時聊天。讓我們找出原因。有許多原因可能導致即時聊天無法顯示。了解以下最常見的原因：

### 檢查允許的網域

如果你在即時聊天中遇到顯示問題，例如無法讀取畫面。這可能是因為你的「允許的網域」設定中未包含嵌入網站的網域。為了確保順利使用聊天功能，請檢查你的設定，新增相應的網域。

<figure><img src="https://842546780-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MNRu7dk70ei7JV9HlW9%2Fuploads%2F0UqVT1mMlkKoXFZ7x1xz%2Fimage.png?alt=media&#x26;token=569d63cb-d9ef-4ecb-bc26-3d1f7040aa1e" alt=""><figcaption></figcaption></figure>

### **檢查 HTML**

首先，請確保你的網站正確包含了即時聊天的 HTML 置入程式碼。你可以按照以下步驟進行檢查：

* 使用瀏覽器造訪你的網站。
* 右鍵點擊頁面上的某個位置，然後選擇“查看頁面原始碼”。
* 在原始碼中，搜尋 “firstline” 文字。

如果你在頁面原始碼中找不到包含“firstline”關鍵字的相應程式碼：

* 請確認你已在所有網站頁面上嵌入了聊天框的程式碼。
* 檢查是否在網站前端運行了任何快取機制。如果有，請嘗試清除所有快取。例如，如果你使用 Cloudflare，可能需要執行相應的清除操作。

<figure><img src="https://842546780-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MNRu7dk70ei7JV9HlW9%2Fuploads%2FVd9S3rkcgGyNbTnwgFQa%2Fimage.png?alt=media&#x26;token=d801973e-b941-49e9-9e13-9848efc7a8fe" alt=""><figcaption></figcaption></figure>

### 檢查 JavaScript 是否運作

FIRST LINE 即時聊天多數透過 JavaScript 來處理資料的運作。在某些特定情況下，比如瀏覽器的安全性設定或是公司的內容安全政策（CSP），可能會對 JavaScript 的運作造成影響。如果你遇到 FIRST LINE 聊天框無法正確顯示的問題，以下是一些解決方案：

#### **停用內容檢查模式**

暫時停用瀏覽器的內容檢查模式，然後檢查 即時聊天是否顯示。這樣可以確保沒有任何內容檢查模式干擾 FIRST LINE 即時聊天的執行。

#### CSPv3 **設定**

FIRST LINE 即時聊天現已全面支援 [Google strict CSPv3](https://csp.withgoogle.com/docs/strict-csp.html) 安全政策。這項 Google 政策為多數網路服務提供了更高的安全標準，同時確保了服務的順暢運作：

```
Content-Security-Policy:
  object-src 'none';
  script-src 'nonce-{random}' 'unsafe-inline' 'unsafe-eval' 'strict-dynamic' https: http:;
  base-uri 'self';
```

為了確保 FIRST LINE 即時聊天能在你的網站上順暢運作，如果你有設定內容安全政策（CSP），請檢查一是否包含了必要的指令。你需要在 script-src 指令中加入 'self'、'unsafe-inline' 以及 'unsafe-eval' 這三項。

* `'unsafe-inline'`：允許在網頁使用內嵌(inline)的 JavaScript 代碼或者樣式 CSS。
* `'unsafe-eval'`：允許使用 eval 方式執行 text-to-JavaScript 機制。

這兩項設定將有助於即時聊天工具的正常運作。

<figure><img src="https://842546780-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MNRu7dk70ei7JV9HlW9%2Fuploads%2FvtqA5hIxkYRFh7k1mLMG%2Fimage.png?alt=media&#x26;token=070fcd1a-0df2-4b82-a02d-7a5145470357" alt=""><figcaption><p>透過瀏覽器開發工具可以檢視相關原因</p></figcaption></figure>

#### 瀏覽器擴充功能干擾

某些瀏覽器擴充功能，可能會阻止一些網頁元素的載入，這可能包括即時聊天。如果你確定你的瀏覽器中啟用了這類擴充功能，請嘗試停用它們，然後重新載入頁面，看看是否解決了問題。有時，你還可以將特定網站列入擴充功能的例外列表，以確保這些擴充功能不會干擾 FIRST LINE 的功能。

### DOS 保護

我們的網路會自動阻止潛在的 DOS 攻擊。如果太多使用者在同一 IP 下連接到 FIRST LINE 即時聊天，將引發 420 錯誤。如果你在使用 FIRST LINE 即時聊天的過程中遇到 420 錯誤，請確保你的使用者並非故意或非法地觸發這個錯誤。同時，你可能需要藉由調整你的網路安全策略，以確保其他用戶能夠順利使用即時聊天服務。
