🧠【Spotfire IronPython 教學】EOL while scanning single-quoted string 是什麼？一次看懂並快速排除（新手也能理解）

 Meta Description

當 Spotfire Automation 或 IronPython Script 出現「EOL while scanning single-quoted string」錯誤時代表什麼？本篇用白話說明原因、常見情境、SQL 與路徑寫法錯誤案例，並提供快速排除方法與最佳實務。

---

一、這個錯誤到底在說什麼？（白話版）

如果你在 Spotfire 自動報表、排程或 Script 裡看到這個錯誤：

EOL while scanning single-quoted string

先不要緊張。
它其實不是資料庫壞掉、不是伺服器掛掉、也不是帳密錯。

它的真正意思只有一句話：

你的文字被電腦讀到一半「沒結束」。

就像你傳 LINE 訊息：

我今天要跟你說「

然後你人就消失了。

對人類來說只是打字沒打完。
但對程式來說是「語法毀滅級錯誤」。

---

二、為什麼 Spotfire 特別容易遇到？

Spotfire 的 Script 使用的是 IronPython（嵌入在 .NET 裡的 Python）。
IronPython 有一個特性：

👉 它在「執行前」會先把整段程式 完整翻譯（編譯）

只要有一個字元不合法，整個腳本直接停止。

也就是：

類型	結果
邏輯錯誤	程式跑到某一段才失敗
語法錯誤（這個）	程式完全不會開始

所以你看到一長串紅字，其實不是很多問題。
只是「一個引號」。

---

三、最核心原因（工程師觀點）

這個錯誤的本質是：

單引號字串沒有關閉

程式語言中，文字必須包在引號內：

"文字"
或
'文字'

但當開始與結束不匹配時，編譯器會一直讀下去，直到行尾（EOL = End Of Line）。

然後它會說：

我已經讀到這行結尾了，但字串還沒結束。

於是報錯。

---

四、最常見的 5 種情境（幾乎 90% 都是）

---

1️⃣ SQL 查詢內含引號

錯誤示意：

query = 'SELECT * FROM Employee WHERE dept = 'IT''

問題：
程式會以為第二個 ' 已經結束字串。

正確寫法：

query = "SELECT * FROM Employee WHERE dept = 'IT'"

---

2️⃣ 多行 SQL

錯誤示意：

query = 'SELECT id
FROM orders
WHERE amount > 100'

IronPython 不允許單引號跨行。

正確寫法（最佳實務）：

query = """
SELECT id
FROM orders
WHERE amount > 100
"""

---

3️⃣ Windows 檔案路徑

這是 Spotfire 最常見兇手

錯誤示意：

folder = 'D:\Reports\Weekly\new'

為什麼？
因為 \n 會被當成「換行符號」

正確寫法：

folder = r'D:\Reports\Weekly\new'

這個 r 叫做 Raw String（原始字串）

---

4️⃣ 字串拼接漏字

錯誤示意：

message = 'Report date: ' + today + '

少了一個結尾引號。

---

5️⃣ 名稱含撇號

例如：

O'Connor
Manager's report

錯誤示意：

name = 'O'Connor'

正確：

name = "O'Connor"

---

五、為什麼錯誤訊息這麼長？

你看到的其實不是錯誤內容，而是：

編譯器「尋找字串結尾」的過程記錄

流程大概是：

1. 讀到 '

2. 開始認為後面都是文字

3. 找不到結束

4. 掃到行尾

5. 宣告失敗

因此整串紅字看起來像系統崩潰，其實只是：

一個符號。

---

六、最快排除法（工程師實戰）

當 Spotfire Script 出現此錯誤時，請照順序做：

Step 1

先找「最後改過的地方」

Step 2

檢查所有 ' 是否成雙

Step 3（重要）

所有 SQL 改成三引號

Step 4（最重要）

所有 Windows 路徑前面加 r

---

七、建議標準寫法（避免未來再發生）

請固定使用這種格式：

SQL

sql_text = """
SELECT product_id, quantity
FROM sales_data
WHERE region = 'APAC'
"""

路徑

export_dir = r'D:\DataOutput\Monthly'

這兩個習慣，能避免 80% Spotfire Script 錯誤。

---

八、為什麼 Automation Services 特別容易爆？

因為 Automation 執行時：

• 沒有人在看畫面

• 不能互動

• 發生語法錯誤就直接停止

結果就是：

報表沒寄出
排程看似成功
但其實什麼都沒做

這也是企業 BI 系統最常見的問題之一。

---

九、一句話總結

如果 Spotfire 出現
EOL while scanning single-quoted string

幾乎可以直接判定：
字串引號寫錯了。

不是資料庫
不是記憶體
不是權限

是「符號」。

---

十、工程師建議（非常重要）

在 Spotfire Script 裡請養成兩個習慣：

1. SQL 永遠使用三引號

2. Windows 路徑永遠使用 raw string

這兩件事會大幅降低自動報表故障率。

---

如果你正在做 Spotfire 自動報表、製程分析或資料平台，
這個錯誤幾乎一定會遇到一次。

但理解後你會發現：

它其實是最容易修的一種錯誤。