> ## Content Index
> Fetch the complete content index at: http://localhost:2368/llms.txt
> Use this file to discover other available public pages before exploring further.

# 正式環境好的，預覽環境卻掛了
- URL: http://localhost:2368/preview-environment-pitfalls/
- Published: 2026-07-06T07:08:11.000Z
- Updated: 2026-08-23T13:54:25.000Z
- Description: 預覽環境的環境變數與登入轉址清單不會繼承正式環境設定；同一份程式一好一壞，先查環境差異不用懷疑程式。
- Author: yuchang23
- Tags: #wiki, #wiki-experience

> **定義**：雲端平台的「環境變數」（存放連線字串、金鑰等設定的地方）在正式環境和預覽環境是各自獨立的——正式環境設好的值，預覽環境不會自動繼承，漏設就掛。

## 當時的症狀 vs 真正的原因

**症狀**：開了預覽環境（給同事先試新功能的分身網站），登入直接壞掉——同一份程式，正式環境明明好好的。

**真正的原因**：預覽環境的環境變數是空的。設定不會從正式環境繼承，要自己補。

## 延伸的地雷

登入服務的「允許轉址網址」清單（登入成功後准許跳回哪些網址的白名單）也要把預覽環境的網址加進去，否則登入會被拒絕。

## Checklist（每次開新的預覽環境）

- 環境變數補齊了沒。
- 登入轉址網址加了沒。

## 症狀對照（快速對號入座）

「同一份程式，一個環境好的、另一個壞的」→ **先查環境設定差異，不用懷疑程式**。

## 相關條目

- [雲端平台會攔截認證標頭的地雷](https://yuchang23.com/auth-header-interception/?ref=localhost)