ThinkPHP 3.0 入口文件重複輸出問題解決：移除 App::run()

ThinkPHP 3.0 入口文件重複輸出問題解決：移除 App::run()

ThinkPHP 3.0 精簡了啟動流程，框架核心文件 ThinkPHP.php 已自動執行應用初始化。若在入口文件中手動調用 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/ThinkPHP.php 源碼 (簡化版)：

<?php
// ThinkPHP.php 核心入口
defined('THINK_PATH') or exit();

// 註冊自動加載
spl_autoload_register('think_autoload');

// 實例化核心應用類並運行
$app = new App();
$app->run(); // 框架內部已自動調用

// 如果用戶再次調用 App::run()，將導致雙重執行
?>

影響範圍

• 頁面 HTML 內容完整重複輸出兩遍
• 數據庫寫入操作 (INSERT/UPDATE) 執行兩次
• Session/ Cookie 可能異常
• 日誌記錄重複
• API 接口返回雙重 JSON 導致前端解析失敗

版本差異說明

排查清單：若移除後仍重複

1. 檢查是否有多個入口文件被包含 (如框架內部重定向)。
2. 檢查模板輸出是否在循環中重複 {volist} 或 foreach。
3. 檢查控制器方法是否被調用兩次 (路由配置錯誤、前端表單重複提交)。
4. 檢查中間件/行為扩展 是否重複註冊。

最佳實踐模板

<?php
// 入口文件標準模板 (ThinkPHP 3.2)
define('APP_DEBUG', true);           // 開發模式
define('APP_NAME', 'Home');          // 項目名
define('APP_PATH', './Application/'); // 模塊目錄
define('BIND_MODULE', 'Home');       // 綁定模塊 (可選)
define('THINK_PATH', './ThinkPHP/'); // 框架核心目錄

// 載入框架核心 (自動運行)
require THINK_PATH . 'ThinkPHP.php';

// 生產環境建議關閉調試、啟用緩存
// define('APP_DEBUG', false);
// define('HTML_CACHE_ON', true);
?>