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

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

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

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

 composer require laravel/telescope

然後運行發(fā)布命令：

 php artisan telescope:install

默認情況下，Telescope 已經(jīng)啟用了數(shù)據(jù)庫相關的監(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)境），進入Queries標籤頁。你會看到每個請求中執(zhí)行的所有數(shù)據(jù)庫查詢。

每條記錄包含以下關鍵信息：

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

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

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

分析慢查詢和重複查詢

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

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

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

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

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

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

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

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

注意事項與小建議

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

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

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