當 XPage 傳送附件失敗：因「xspupload」臨時資料夾不存在所致

在 IBM Domino / XPages 環境中，文件與附件的上傳流程往往會透過 臨時資料夾（tmp folder）來暫存檔案。若該資料夾未建立或權限不足，系統將直接返回「attachment upload failed」錯誤，造成開發者與用戶的困擾。本文將針對「xspupload」資料夾缺失時的排除流程、修復方式，以及預防措施作為核心說明。

了解臨時資料夾在 XPage 上傳中的角色

在 XPages 裡，上傳檔案的機制一般會走以下流程：

HTTP 請求被送至 Domino 伺服器；
處理程式會先在伺服器上建立一個「臨時資料夾」來存放已上傳的檔案；
檔案經過驗證與處理後，移至最終存放目錄（例如 Notes 文檔或外部檔案系統）。

若要改變Domino Server 的temp路徑(windows下預設為作業系統環境變數指定) notes.ini 內以 notes.ini 變數 NOTES_TEMPDIR= 指定。若預設值不存在或暫存資料夾下沒xspupload 資料夾時，因實際伺服器上並無對應資料夾，則上傳會在伺服器層面直接失敗，而不會在前端顯示「檔案太大」或「格式不符」等提示。

診斷「xspupload」資料夾是否缺失

最常見的排查方式：

在 Domino Server notes.ini 確認是否指定暫存資料夾如NOTES_TEMPDIR= 等路徑
若使用 Windows Server，可透過 Event Viewer 搜尋 “File upload” 的錯誤訊息，通常會顯示「無法建立臨時資料夾」之類的描述。

檢查環境變數temp路徑昃否有相關temp路徑

在 Domino Server 以程式化方式創建資料夾（可在 XPages 中使用）

若想讓部署時自動檢查並建立資料夾，可在 onStart 事件中加入下列 Groovy/Java 代碼：

import java.io.File

def tmpDirPath = context.getServletContext().getInitParameter("com.ibm.xsp.upload.tmp.dir") ?: "xspupload"
def tmpDir = new File(tmpDirPath)
if (!tmpDir.exists()) {
    tmpDir.mkdirs()
    // 設定完整權限
    if (System.getProperty("os.name").toLowerCase().contains("windows")) {
        def r = tmpDir.setExecutable(true, false)
        r &= tmpDir.setReadable(true, false)
        r &= tmpDir.setWritable(true, false)
    }
}

此段程式碼會在每次伺服器啟動時確認資料夾是否存在，未存在則自動建立並賦予執行、讀取、寫入權限，避免手動操作。