要啟用 Laravel Telescope 的數(shù)據(jù)庫監(jiān)控，首先要安裝擴(kuò)展并確認(rèn)配置。1. 用 Composer 安裝：composer require laravel/telescope；2. 發(fā)布配置：php artisan telescope:install；3. 確保 config/telescope.php 中的 QueryWatcher 設(shè)置為 true；4. 在本地開發(fā)環(huán)境中訪問 /telescope 頁面，進(jìn)入 Queries 標(biāo)簽查看 SQL 語句、綁定參數(shù)、執(zhí)行時間和調(diào)用位置；5. 可按耗時排序識別慢查詢，或發(fā)現(xiàn)重復(fù)查詢以優(yōu)化性能；6. 注意 Telescope 默認(rèn)僅在非生產(chǎn)環(huán)境生效，避免敏感數(shù)據(jù)泄露。

Laravel Telescope 是一個強(qiáng)大的調(diào)試工具，尤其在調(diào)試數(shù)據(jù)庫查詢時非常實用。它能讓你直觀地看到請求期間執(zhí)行的所有 SQL 語句、綁定參數(shù)、執(zhí)行時間等信息，幫助你快速定位慢查詢或錯誤邏輯。

如何啟用 Telescope 的數(shù)據(jù)庫監(jiān)控

首先確保你已經(jīng)安裝并啟用了 Laravel Telescope。如果還沒裝，可以用 Composer 安裝：

composer require laravel/telescope

然后運(yùn)行發(fā)布命令：

php artisan telescope:install

默認(rèn)情況下，Telescope 已經(jīng)啟用了數(shù)據(jù)庫相關(guān)的監(jiān)聽器。你可以檢查 config/telescope.php 中的 watchers 配置項：

'watchers' => [
    ...
    Laravel\Telescope\Watchers\QueryWatcher::class => true,
],

只要這個配置是 true，所有數(shù)據(jù)庫查詢都會被記錄到 Telescope 中。

查看具體的數(shù)據(jù)庫查詢信息

打開瀏覽器訪問 /telescope 頁面（前提是你的環(huán)境是本地開發(fā)環(huán)境），進(jìn)入 Queries 標(biāo)簽頁。你會看到每個請求中執(zhí)行的所有數(shù)據(jù)庫查詢。

每條記錄包含以下關(guān)鍵信息：

• 執(zhí)行的 SQL 原始語句
• 綁定參數(shù)（帶占位符替換）
• 查詢耗時
• 觸發(fā)該查詢的文件和行號（這對定位問題特別有用）

比如你會發(fā)現(xiàn)某條查詢用了 where('id', '1')，但實際生成的 SQL 卻是 where id = ?，而綁定值顯示為 [1]，這說明參數(shù)綁定正常，也能確認(rèn)是否傳入了正確的值。

小技巧：如果你看到某個查詢耗時明顯偏高，可以復(fù)制 SQL 到數(shù)據(jù)庫客戶端手動執(zhí)行，看看是否索引缺失或者語句結(jié)構(gòu)有問題。

分析慢查詢和重復(fù)查詢

在調(diào)試過程中，有兩個常見的性能問題可以通過 Telescope 快速識別：

• 慢查詢：在 Queries 頁面，可以根據(jù)“Duration”排序，找出最耗時的查詢。
• 重復(fù)查詢：有些代碼可能會在一個請求里多次執(zhí)行相同的 SQL，比如在循環(huán)中調(diào)用模型查詢。Telescope 會把它們都記錄下來，方便你發(fā)現(xiàn)這種低效寫法。

舉個例子，假設(shè)你在 Blade 模板中這樣寫：

@foreach ($users as $user)
    {{ $user->profile->name }}
@endforeach

如果沒有做預(yù)加載，Telescope 會顯示多個 select * from profiles where user_id = ? 的查詢，這就是典型的 N 1 問題。

解決方法也很簡單，使用 Eloquent 的 with() 方法預(yù)加載關(guān)聯(lián)數(shù)據(jù)：

$users = User::with('profile')->get();

刷新頁面后，你會發(fā)現(xiàn)只執(zhí)行了一次 profile 查詢，效率大大提升。

注意事項與小建議

• Telescope 默認(rèn)只在非生產(chǎn)環(huán)境下生效，所以不用擔(dān)心暴露敏感數(shù)據(jù)。
• 如果你發(fā)現(xiàn) Telescope 沒有記錄查詢，檢查是否開啟了 Query Watcher，同時確保沒有在代碼中使用 DB::disableQueryLog()。
• 對于復(fù)雜的查詢構(gòu)建器操作，也可以結(jié)合 Telescope 和日志輸出來輔助分析。

基本上就這些。合理使用 Laravel Telescope 可以省去很多打印日志、調(diào)試變量的時間，尤其是在排查數(shù)據(jù)庫相關(guān)問題時，效率提升非常明顯。

以上是使用Laravel望遠(yuǎn)鏡調(diào)試數(shù)據(jù)庫查詢？的詳細(xì)內(nèi)容。更多信息請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！