錯誤及問題排除
本章彙整 Weincloud 帳號與登入相關的常見問題，說明每個症狀的成因、判斷依據與處置方式，協助使用者與管理員在無法登入或操作被拒絕時快速定位原因。
適用對象與範圍：
- 一般使用者：登入失敗、忘記密碼、收不到驗證信、多因子驗證（MFA）異常等自助排除。
- Domain Superuser 與 Subdomain Superuser：協助成員解除帳號鎖定、重設 MFA、確認 Domain 層級策略是否為問題來源。
- 本章不包含 HMI 啟用與授權、EasyAccess 2.0 連線、Dashboard 專案等錯誤；該類問題請參閱對應章節。
錯誤訊息的呈現方式
判斷問題前，先確認訊息出現在哪一層，可縮小排查範圍：
| 呈現方式 | 來源 | 特徵 |
|---|---|---|
| 欄位下方的紅色提示 | 瀏覽器端的格式檢查 | 尚未送出請求，僅代表欄位格式不符 |
| 浮動提示訊息（Toast） | 伺服器回應的錯誤 | 顯示約 5 秒後自動消失，內容即為實際失敗原因 |
| 對話框或系統提示 | 需使用者確認才能繼續的事件 | 例如作業階段過期，確認後強制導回登入頁 |
| 獨立錯誤頁面 | 路由層級的存取失敗 | 顯示 403、404、503 等狀態碼 |
部分錯誤除了顯示訊息外，還會自動導向其他頁面（例如密碼強度不足時導向密碼重設頁）。若畫面在提示後自行跳轉，屬預期行為，請依跳轉後的頁面完成處置。
無法登入
登入頁需輸入〔Domain〕、〔使用者名稱〕與〔密碼〕三項資訊。管理員帳號的使用者名稱固定為 admin。
送出前，瀏覽器會先檢查下列條件，未通過時不會送出請求：
- 三個欄位皆為必填。
- 密碼至少 6 個字元，欄位可輸入的上限為 16 個字元。
通過欄位檢查後仍失敗時，依伺服器回應的訊息判斷原因：
| 訊息 | 原因 | 處置 |
|---|---|---|
| 此 Domain 名稱不存在 | Domain 名稱拼寫錯誤，或該 Domain 尚未建立 | 確認 Domain 名稱；Domain 名稱長度為 4–32 個字元，僅含英文字母、數字與底線 |
| 使用者不存在 | 該 Domain 下沒有此使用者名稱 | 確認使用者名稱；管理員帳號為 admin。使用者名稱長度為 4–32 個字元 |
| 密碼錯誤 | 密碼不正確 | 重新輸入。連續失敗會觸發鎖定，見帳號遭鎖定 |
| Domain 尚未確認 | 註冊後未完成電子郵件確認 | 見帳號尚未完成驗證 |
若確認三項資訊皆正確仍無法登入，依序檢查下列各節的限制條件。
帳號遭鎖定
連續驗證失敗達到門檻時，帳號會被鎖定，此後即使輸入正確的密碼或驗證碼也無法登入。
密碼與**驗證碼（OTP）**分別計數，兩者門檻獨立，達到任一門檻即觸發鎖定。此門檻為系統固定值，不隨 Domain 的策略而改變：
| 驗證類型 | 觸發門檻 |
|---|---|
| 密碼 | 連續失敗 20 次 |
| 驗證碼（OTP） | 連續失敗 5 次 |
驗證碼的計數涵蓋所有輸入 6 位數驗證碼的環節，包含〔雙因素驗證〕畫面與電子郵件驗證碼登入。因此帳號可能在密碼完全正確的情況下，僅因驗證碼反覆輸入錯誤而遭鎖定。
鎖定的解除方式則由該 Domain 的〔失敗嘗試策略〕決定：
| 策略 | 提示訊息 | 解除方式 |
|---|---|---|
| 〔預設〕 | 您的帳號已暫時鎖定，請在 30 分鐘後再試。 | 鎖定 30 分鐘，逾時自動解除 |
| 〔嚴格〕 | 登入次數已達上限，請聯絡管理員解除鎖定。 | 不會自動解除，須由管理員手動解除 |
策略為 Domain 層級設定，套用於該 Domain 下的所有使用者，設定方式見設定－失敗嘗試策略。該 Domain 維持〔未設定〕時，鎖定保護仍然生效，行為同〔預設〕。
admin 帳號的例外
使用者名稱為 admin 的帳號不適用〔嚴格〕策略的持續鎖定。無論該 Domain 設定為何種策略，admin 觸發鎖定後一律為暫時鎖定 30 分鐘，逾時自動解除，無須他人協助解鎖。
處置方式：
- 〔預設〕策略：等待 30 分鐘後重試。若不確定正確密碼，直接改用密碼重設流程，重設成功後鎖定即解除，無須等待。
- 〔嚴格〕策略：完成密碼重設即可自行解除鎖定；無法使用密碼重設時，聯絡該 Domain 的 Domain Superuser，於〔User〕頁面對該帳號執行〔解除鎖定〕。此操作僅 Domain Superuser 可執行，且僅在帳號目前處於鎖定狀態時才會出現，詳見使用者管理。
admin帳號：不論策略為何，等待 30 分鐘後即可重試，處理方式同〔預設〕策略。- 因驗證碼錯誤而鎖定：解除方式與上述相同。解除後請先依多因子驗證（MFA）問題確認可正常取得驗證碼，再重新登入，避免再次觸發鎖定。
登入 IP 不在允許範圍
畫面顯示「此 IP 不允許登入」時，代表該帳號已設定登入 IP 限制，而目前的連線來源不在允許的 IP 範圍內。此限制僅適用於使用者名稱為 admin 的帳號。
處置方式：
- 改由允許的網路環境登入，例如公司內部網路或指定據點。
- 需調整允許範圍時，須先以允許範圍內的來源登入，再於〔Profile〕頁面的〔登入 IP 限制〕修改，詳見帳號設定－登入 IP 限制。
設定登入 IP 限制前，請確認清單已包含目前使用的 IP，否則儲存後將無法自該處登入。
密碼強度未達要求
Domain 啟用〔密碼強度〕後，既有密碼不會立即失效，而是在下次登入時檢查。若現有密碼不符合要求，系統顯示「密碼強度未達安全要求，請立即變更密碼」並自動導向密碼重設頁面，須完成變更後方可繼續使用。
此情況下的新密碼要求較平時嚴格：最短長度由 6 個字元提高為 8 個字元，且須同時包含大寫字母、小寫字母、數字與特殊字元。政策說明見設定－密碼強度。
帳號尚未完成驗證
新註冊的 Domain 須完成電子郵件確認才能登入。註冊完成後，系統會將確認信寄至註冊時填寫的電子郵件地址，點擊信中連結即完成啟用。
未完成確認即登入時，畫面顯示「Domain 尚未確認」。處置方式：
- 檢查註冊信箱的收件匣與垃圾郵件匣。
- 未收到信件時，於登入頁點擊〔尚未收到認證信〕，輸入 Domain 與使用者名稱後點擊〔傳送〕，系統重新寄出驗證連結。
- 若點擊連結後顯示「連結已過期」，代表該連結無效或已逾期，請依上一步重新取得新的驗證連結。
註冊流程詳見開始使用 Weincloud。
隱私權政策已更新
隱私權政策更新後，系統會在登入時要求重新同意，訊息為「我們已更新隱私權政策，請同意後繼續使用 Weincloud」。依畫面指示閱讀並同意後即可繼續使用；未同意前無法存取其他功能。
忘記密碼與密碼重設
密碼重設同時是忘記密碼與解除帳號鎖定的通用解法：重設成功後，鎖定狀態隨即解除，且不受該 Domain 的〔失敗嘗試策略〕影響。
取得密碼重設連結
- 於登入頁點擊〔忘記密碼〕，開啟〔重設密碼〕對話框。
- 輸入〔Domain〕與〔使用者名稱〕，兩個欄位皆為必填。
- 點擊〔傳送〕。送出成功後顯示「密碼重設信已傳送。」，重設連結將寄至該帳號的電子郵件地址。
若輸入的 Domain 或使用者名稱不存在，對話框不會關閉，並以提示訊息說明失敗原因，可修正後直接重試。
設定新密碼
點擊信中連結進入〔重設密碼〕頁面，輸入〔新密碼〕與〔確認密碼〕後點擊〔設定新密碼〕。
- 密碼長度為 6–16 個字元；若本次重設是由密碼強度政策觸發，最短長度為 8 個字元。
- 兩次輸入的密碼必須一致。
- 輸入時，欄位下方以四段式強度指示（〔弱〕、〔普通〕、〔良好〕、〔強〕）即時顯示密碼強度，供參考用。
完成後畫面顯示「您的密碼已更新，現在可以使用新密碼登入。」並返回登入頁，須以新密碼登入。
重設失敗的處理
| 症狀 | 原因 | 處置 |
|---|---|---|
開啟連結後顯示 404 頁面 | 網址缺少重設用的權杖，通常是連結被截斷或未完整複製 | 從信件中重新點擊完整連結，或重新申請一次重設信 |
| 點擊〔設定新密碼〕後顯示錯誤訊息 | 重設連結已逾期或已使用過 | 重新申請一次重設信；每封重設信僅供一次使用 |
| 收不到重設信 | 見收不到系統信件 | — |
收不到系統信件
Weincloud 以電子郵件送出註冊確認信、密碼重設信與驗證碼。收不到信件時依序檢查：
- 確認收件位置：驗證信與重設信寄至該帳號註冊的電子郵件地址，並非登入時輸入的使用者名稱。
- 檢查垃圾郵件匣：系統信件可能被歸類為垃圾郵件。
- 確認寄送頻率限制：驗證碼的重新寄送有間隔限制，過於頻繁時會顯示「您可以在 60 秒後重新寄送驗證碼」，須等待倒數結束。
- 確認驗證碼未過期：驗證碼有有效期限，逾期使用會顯示「驗證碼已過期」，須重新取得。
- 確認電子郵件地址正確：登入後可於〔Profile〕頁面檢視與變更電子郵件地址，並確認其驗證狀態，詳見帳號設定－電子郵件。
若帳號的電子郵件地址已無法收信且尚未變更，須聯絡該 Domain 的 Domain Superuser 協助處理。
多因子驗證（MFA）問題
啟用 MFA 後，通過密碼驗證會進入〔雙因素驗證〕畫面，須輸入 6 位數驗證碼才完成登入。驗證碼的來源依所選方式而定：〔Email OTP〕寄至註冊的電子郵件；〔Email + TOTP App〕由驗證器 App 產生，並以電子郵件作為備援。
| 症狀 | 處置 |
|---|---|
| 收不到電子郵件驗證碼 | 點擊〔重新傳送驗證碼〕；按鈕在倒數結束前為停用狀態，須等待倒數完成。並依收不到系統信件檢查 |
| 驗證器 App 的驗證碼一直驗證失敗 | TOTP 驗證碼具時效性，請確認裝置時間為自動校時且時區正確，再重新取得驗證碼 |
| 更換手機或遺失驗證器 App | 〔Email + TOTP App〕以電子郵件作為備援，可改由電子郵件接收驗證碼登入；登入後於〔Profile〕頁面重新設定 MFA 以綁定新裝置 |
| 電子郵件與驗證器 App 皆無法使用 | 聯絡該 Domain 的 Domain Superuser，於〔User〕頁面對該帳號執行〔重設 MFA〕。此操作僅 Domain Superuser 可執行，且僅在該使用者已啟用 MFA 時才會出現 |
| 無法選擇〔Email OTP〕或〔Email + TOTP App〕 | 帳號的電子郵件尚未驗證。請先完成電子郵件驗證，詳見帳號設定－驗證電子郵件 |
| 反覆輸入錯誤後顯示帳號已鎖定 | 驗證碼連續輸入錯誤 5 次即鎖定帳號，門檻低於密碼的 20 次。解除方式見帳號遭鎖定 |
MFA 的設定方式與登入流程詳見帳號設定－多因子驗證。
社群登入問題
以 Google、Microsoft、Apple、微信或電子郵件驗證碼登入時，可能出現下列情況：
| 訊息或症狀 | 原因 | 處置 |
|---|---|---|
| 此社群登入帳號已連結到其他使用者 | 一個 Weincloud 帳號同時只能連結一組社群帳號；要連結的帳號已有社群連結 | 改以該帳號原本連結的社群帳號登入，或先於該帳號的〔Profile〕頁面解除連結後再重新連結 |
| 社群登入 Token 無效／已過期 | 授權流程逾時，或授權頁面停留過久 | 返回登入頁重新執行一次社群登入 |
| 找不到社群登入狀態 | 授權流程中途中斷，例如重新整理頁面或使用瀏覽器上一頁 | 返回登入頁重新執行，過程中請勿重新整理或離開頁面 |
| 電子郵件驗證碼顯示已過期 | 一次性驗證碼有有效期限，畫面上以倒數秒數顯示 | 點擊〔重新傳送驗證碼〕取得新的驗證碼 |
| 微信 QR 碼顯示已過期 | QR 碼有有效期限 | 重新開啟登入對話框以取得新的 QR 碼 |
| 完成授權後顯示〔選擇帳號〕且清單為空 | 該社群帳號尚未連結任何 Weincloud 帳號 | 依對話框指示〔建立新帳號〕或〔連結現有帳號〕 |
社群登入的機制、可用的提供者，以及社群身分與 Weincloud 帳號的對應關係，見社群登入與社群登入－社群身分與 Weincloud 帳號的對應關係。
TIP
可用的提供者由伺服器決定：全球伺服器提供 Email、Google、Microsoft 與 Apple；中國伺服器提供 Email 與微信。
作業階段與被強制登出
登入後系統會自動維持作業階段，權杖到期時於背景更新，使用者通常不會察覺。下列情況會中止作業階段：
| 症狀 | 原因 | 處置 |
|---|---|---|
| 顯示作業階段已過期的提示，確認後導回登入頁 | 權杖已失效且無法自動更新，例如閒置過久 | 重新登入。系統會保留原本的頁面位址，登入後自動返回該頁 |
| 操作中突然被登出 | 該登入會話已在其他裝置上被登出，或帳號密碼已變更 | 重新登入。可於〔Profile〕頁面的〔登入會話〕檢視目前有效的登入紀錄，詳見帳號設定－登入會話 |
| 變更密碼後被要求重新登入 | 密碼變更成功後強制重新登入 | 以新密碼登入，屬預期行為 |
| 登入後被導向〔Profile〕頁面且無法前往其他頁面 | 帳號的電子郵件尚未驗證，或帳號正處於排程刪除狀態 | 完成電子郵件驗證；帳號排程刪除中時可執行〔取消刪除〕以恢復正常狀態，詳見帳號設定－取消刪除 |
發現非預期的登入紀錄時，建議立即執行〔全部登出〕、變更密碼，並啟用 MFA。
權限不足與頁面存取錯誤
| 症狀 | 原因 | 處置 |
|---|---|---|
| 顯示「權限不足」、「您沒有存取權限」或「權限檢查失敗」 | 目前帳號的角色或資料夾範圍不足以執行該操作 | 確認所需權限，並向 Domain Superuser 申請。權限模型見使用者管理與Subdomain 的管理 |
| 選單中看不到某個功能 | 選單依帳號權限動態顯示，無權限的項目不會出現 | 同上，確認帳號是否具備該功能所需權限 |
顯示 403 錯誤頁面 | 直接以網址存取無權限的頁面 | 返回〔Directory〕頁面，改由選單進入有權限的功能 |
顯示 404 錯誤頁面 | 網址錯誤，或該資源已被刪除 | 確認網址；若由書籤或舊連結進入，請重新自選單導覽 |
管理者調整權限後，該使用者需重新登入才會套用新的選單與存取範圍。
服務暫時無法使用
| 訊息或症狀 | 原因 | 處置 |
|---|---|---|
| 您送出的請求過多 | 短時間內送出的請求超過伺服器限制 | 停止重複操作，稍候再試。避免連續點擊送出按鈕 |
| 伺服器無法使用 | 伺服器暫時無法回應 | 稍候再試；持續發生時聯絡客服 |
| 服務發生內部問題 | 伺服器端異常 | 稍候再試；若持續失敗，請記錄操作步驟與時間並聯絡客服 |
顯示 503 錯誤頁面 | 伺服器過載或正在維護 | 稍候再試 |
| 頁面長時間無回應後失敗 | 單一請求逾時（上限 30 秒） | 縮小查詢範圍後重試，例如減少日期區間或篩選條件 |
限制與注意事項
| 項目 | 限制 |
|---|---|
| Domain 名稱 | 4–32 個字元，僅含英文字母、數字與底線 |
| 使用者名稱 | 4–32 個字元；不可自行變更 |
| 密碼長度 | 6–16 個字元；Domain 啟用〔密碼強度〕後最短為 8 個字元 |
| 登入失敗鎖定門檻 | 密碼連續失敗 20 次；驗證碼（OTP）連續失敗 5 次，兩者獨立計數 |
| 鎖定解除方式 | 〔預設〕鎖定 30 分鐘後自動解除；〔嚴格〕須管理員解除 |
| 〔嚴格〕策略適用範圍 | 不適用於 admin；該帳號一律鎖定 30 分鐘後自動解除 |
| 驗證碼重新寄送 | 須間隔 60 秒 |
| 驗證連結與驗證碼 | 具有效期限，逾期須重新取得；重設密碼連結僅供一次使用 |
| 登入 IP 限制 | 僅使用者名稱為 admin 的帳號可用；最多 5 筆；僅支援 IPv4 的 CIDR 格式 |
| 解除帳號鎖定、重設 MFA | 僅 Domain Superuser 可執行 |
| 單一請求逾時 | 30 秒 |
常見問題
Q：帳號被鎖定後，等待多久會自動解除？
A：取決於該 Domain 的〔失敗嘗試策略〕。〔預設〕策略鎖定 30 分鐘後自動解除；〔嚴格〕策略不會自動解除，須由 Domain Superuser 手動解鎖。兩種策略的觸發門檻相同，差異僅在於是否自動解除。
使用者名稱為 admin 的帳號是唯一例外：不論策略為何，一律鎖定 30 分鐘後自動解除。
Q：密碼明明沒輸錯，為什麼帳號會被鎖定？
A：驗證碼（OTP）與密碼分別計數，驗證碼連續輸入錯誤 5 次即鎖定帳號，門檻遠低於密碼的 20 次。若驗證器 App 時間未校準或反覆使用過期的電子郵件驗證碼，很容易在密碼完全正確的情況下觸發鎖定，見多因子驗證（MFA）問題。
Q：忘記密碼可以解除帳號鎖定嗎？
A：可以。完成密碼重設後鎖定狀態即解除，無須等待鎖定時間結束。〔嚴格〕策略下同樣適用，因此不一定要聯絡 Domain Superuser。
Q：忘記使用者名稱或 Domain 名稱怎麼辦？
A：管理員帳號的使用者名稱固定為 admin。其餘帳號請聯絡該 Domain 的 Domain Superuser 查詢；密碼重設與重寄驗證信皆須同時提供 Domain 與使用者名稱，無法僅以電子郵件地址進行。
Q：為什麼輸入正確密碼仍顯示密碼錯誤？
A：請確認〔Domain〕欄位正確。相同的使用者名稱可能存在於不同 Domain，Domain 填錯時系統會以另一個帳號驗證密碼。此外請確認未開啟大寫鎖定。
Q：為什麼登入後被強制導向密碼重設頁面？
A：該 Domain 已啟用〔密碼強度〕，而目前密碼不符合要求。請完成密碼變更後再繼續使用。
Q：管理員可以直接查看使用者的密碼嗎？
A：不行。管理員只能於使用者詳細資料頁為其重設密碼，過程中須輸入管理員本人的密碼進行身分驗證。