還在手刻 cURL？Laravel x LINE Login API 串接終極指南：用 Socialite 打造秒登入的絲滑體驗

嗨，我是浪花科技的資深工程師 Eric。今天我們來聊聊一個老生常談，但每次 Code Review 看到還是會讓我血壓升高的主題：Laravel 與 LINE Login API 串接。

這年頭，如果要讓使用者註冊網站，還要他們填寫 Email、設定密碼、收驗證信，流失率大概會高達 80%。所以，社群登入（Social Login）是標配。而在台灣，LINE 的滲透率無人能敵，LINE Login 絕對是你的首選。

但是！我拜託各位（尤其是剛轉職的工程師們），不要再 Controller 裡面手寫 curl 去打 LINE 的 OAuth API 了！ 那樣做不僅程式碼像義大利麵一樣難維護，安全性也是一個大漏洞。Laravel 已經幫我們準備好了最強大的武器 —— Laravel Socialite，搭配 SocialiteProviders，這才是優雅的解決方案。

今天這篇文章，我就以 2025 年最新的環境，手把手帶大家用最正規的方式，搞定 LINE Login。

為什麼選擇 Socialite 而不是手刻？

簡單說兩句工程師的思維。OAuth 2.0 的流程包含：導向授權頁面 -> 接收 Callback Code -> 用 Code 換 Token -> 用 Token 換 User Profile。這中間涉及 State 參數的驗證（防止 CSRF 攻擊）、錯誤處理、Token 的保存等等。

• 手刻：你需要自己寫這四個步驟，還要自己處理 HTTP Client，自己 try-catch 錯誤。
• Socialite：兩行程式碼解決。一行 redirect，一行 user()。

別再造輪子了，把時間拿去喝杯咖啡不好嗎？

第一步：LINE Developers Console 設定

在寫 Code 之前，我們得先去 LINE 把「場子」佈置好。這一步最容易出錯，請看仔細。

1. 前往 LINE Developers Console，建立一個 LINE Login 的 Channel。
2. Channel ID 和 Channel Secret：這兩個是你的鑰匙，等下要填到 `.env` 裡。
3. Callback URL (重要！)：這是新手最容易卡關的地方。LINE 要求嚴格的白名單驗證。
   • 如果是本地開發，請不要填 `http://localhost` 或 `http://127.0.0.1`。LINE 要求必須是 HTTPS 且不能是 localhost（雖然有些舊文件說可以，但在 OAuth 2.0 規範下，用 ngrok 才是正解）。
   • 推薦使用 ngrok 產生一個 https 網址，例如：`https://你的-ngrok-id.ngrok-free.app/login/line/callback`。
   • 將這個網址填入 LINE Console 的 LINE Login > Callback URL 設定中。
4. OpenID Connect：在「Email address permission」的地方，記得申請「Applied」，否則你抓不到使用者的 Email。

第二步：安裝與設定 Laravel Socialite

回到我們的 Laravel 專案（這裡假設你已經用的是 Laravel 10 或 11）。

1. 安裝套件

我們需要安裝官方的 Socialite 以及社群維護的 LINE Provider。

composer require laravel/socialite
composer require socialiteproviders/line

2. 設定 Service Provider (Laravel 11 可略過此步)

如果你還在用 Laravel 10 或更早版本，請打開 config/app.php，確認 providers 有包含 Socialite，但更重要的是，要在 EventServiceProvider 註冊 LINE 的事件監聽器。

在 app/Providers/EventServiceProvider.php 中加入：

protected $listen = [
    \SocialiteProviders\Manager\SocialiteWasCalled::class => [
        // ... 其他 providers
        \SocialiteProviders\Line\LineExtendSocialite::class.'@handle',
    ],
];

3. 設定 Config 與 .env

打開 config/services.php，加入 LINE 的設定：

'line' => [
    'client_id' => env('LINE_CLIENT_ID'),
    'client_secret' => env('LINE_CLIENT_SECRET'),
    'redirect' => env('LINE_REDIRECT_URI'),
],

接著，在你的 .env 檔案中填入真實資訊：

LINE_CLIENT_ID=你的Channel_ID
LINE_CLIENT_SECRET=你的Channel_Secret
LINE_REDIRECT_URI=https://你的-ngrok-id.ngrok-free.app/login/line/callback

第三步：撰寫 Controller 與 Route

這是最核心的部分。我們需要兩個路由：一個把使用者「踢」去 LINE 登入頁面，一個是用來「接」使用者回來的地方。

LoginController.php

<?php

namespace App\Http\Controllers\Auth;

use App\Http\Controllers\Controller;
use Laravel\Socialite\Facades\Socialite;
use App\Models\User;
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Str;
use Exception;

class LineLoginController extends Controller
{
    // 1. 重導向至 LINE 登入頁面
    public function redirectToProvider()
    {
        // Eric小提醒：這裡可以加 scopes，例如想要抓 email，就要 openid, email
        return Socialite::driver('line')->redirect();
    }

    // 2. 處理 Callback
    public function handleProviderCallback()
    {
        try {
            // 這裡 Socialite 自動幫你做了 state 驗證和 token 交換，舒服！
            $lineUser = Socialite::driver('line')->user();
            
            // 這裡可以 dump 出來看看 $lineUser 裡面有什麼
            // dd($lineUser);

            // 登入或註冊邏輯
            $user = User::updateOrCreate(
                ['line_id' => $lineUser->getId()], // 用 LINE ID 判斷是否已存在
                [
                    'name' => $lineUser->getName(),
                    'email' => $lineUser->getEmail(), // 記得 LINE Console 要開權限才抓得到
                    'avatar' => $lineUser->getAvatar(),
                    'password' => bcrypt(Str::random(16)), // 給個隨機密碼
                    'line_token' => $lineUser->token, // 建議存下來，之後如果要打其他 API 會用到
                ]
            );

            // 登入該使用者
            Auth::login($user, true);

            return redirect()->route('dashboard'); // 導向你的首頁

        } catch (Exception $e) {
            // 錯誤處理：例如使用者在 LINE 頁面按了取消
            // Log::error($e->getMessage());
            return redirect()->route('login')->with('error', 'LINE 登入失敗，請重試。');
        }
    }
}

routes/web.php

use App\Http\Controllers\Auth\LineLoginController;

Route::get('login/line', [LineLoginController::class, 'redirectToProvider'])->name('login.line');
Route::get('login/line/callback', [LineLoginController::class, 'handleProviderCallback']);

Eric 的實戰除錯筆記：那些年我們踩過的坑

程式碼看起來很簡單，但實際跑起來，通常會遇到這幾個鬼故事：

1. 400 Bad Request

這 99% 都是 Callback URL 不一致 造成的。請檢查：

• LINE Console 填寫的 Callback URL。
• .env 裡的 LINE_REDIRECT_URI。
• 如果是用 ngrok，每次重啟 ngrok 網址會變，記得去 LINE Console 更新（或者付費買固定的 ngrok domain）。

2. 抓不到 Email

$lineUser->getEmail() 回傳 null？這不是程式碼的問題。

• 去 LINE Console > OpenID Connect > Email address permission，狀態必須是「Applied」或「Granted」。
• 如果還在開發模式（非 Verified Channel），你的 LINE 帳號必須有綁定 Email 才能抓到。

3. 若有似無的 State Mismatch

這通常發生在你的 Session 設定有問題，或者你用了 dd() 在 redirect 之前把 session 截斷了。確保你的 config/session.php 中的 secure 設定正確（本地開發如果是 http，secure 要設為 false，但在 ngrok 下是 https，這有時候會搞混 cookie）。最簡單的方法是，確保全程使用 HTTPS。

進階思考：登入之後呢？

LINE Login 只是第一步。真正的商業價值在於取得使用者的身份後，如何將這些散落在各地的資料整合起來。例如，他是否同時也是你 Facebook 粉絲頁的粉絲？他的 Email 是否已經在你的 CRM 系統中？

如果你對「整合使用者身份」或「後續的資料應用」感興趣，強烈建議閱讀以下幾篇深度文章，這會讓你的系統架構從「玩具」升級為「企業級產品」。

延伸閱讀

• 你的客服在玩『猜猜我是誰』？終極 API 戰術，一次搞定 Facebook 與 LINE 用戶整合！
• API 金鑰之亂終結者：Laravel + JWT 深度實戰，打造無狀態認證的現代化後端！
• Laravel Webhook 不只是『打出去』就好！資深工程師帶你打造企業級『事件驅動』架構

希望這篇文章能幫助大家快速搞定 LINE Login。技術本身不難，難的是魔鬼細節。如果你在實作上遇到任何奇怪的 Bug，或者需要將這套系統整合到更複雜的 CRM 架構中，歡迎隨時找我們聊聊！