ThinkPHP 3.0 入口文件重複輸出問題：App::run() 調用時機解析

問題現象

入口文件調用 `App::run()` 導致頁面內容輸出兩次。

錯誤入口代碼

<?php
define('APP_NAME', 'Admin');
define('APP_PATH', './Admin/');
define('THINK_PATH', './ThinkPHP/');
require THINK_PATH . 'ThinkPHP.php';
App::run(); // 多餘調用導致雙重執行
?>

正確入口代碼

<?php
define('APP_NAME', 'Admin');
define('APP_PATH', './Admin/');
define('THINK_PATH', './ThinkPHP/');
require THINK_PATH . 'ThinkPHP.php';
// App::run(); // 註釋或刪除
?>

核心原理

ThinkPHP 3.0 核心文件 `ThinkPHP.php` 內部已自動執行應用啟動流程：

// ThinkPHP.php 簡化邏輯
// ... 核心類加載 ...
App::run(); // 內部已調用
// ...

入口文件再次調用 `App::run()` 導致雙重執行：

1. 首次：核心文件內部自動執行
2. 二次：入口文件顯式調用

版本演進對比

排查思路

1. 發現重複輸出 → 檢查入口文件是否多調用啟動方法
2. 查看核心框架入口文件是否已包含啟動邏輯
3. 對照官方文檔該版本標準入口寫法
4. 刪除多餘調用 → 測試驗證

最佳實踐

• 嚴格遵循對應版本官方文檔入口文件範例
• 升級框架時同步更新入口文件
• 保持入口文件極簡，僅做常量定義與核心加載

一行多餘代碼引發的雙重執行，提醒我們：框架升級必讀遷移指南，入口文件是遷移首要檢查點。