如何为Strapi v4添加自定义Line登录授权提供商

直接修改node_modules目录下的核心插件文件是不可靠的——项目重启、依赖重装或版本更新后，所有修改都会丢失，且容易引发兼容性问题。Strapi V4提供了官方的插件扩展机制，无需改动核心依赖即可实现自定义OAuth2 provider配置，以下是针对Line登录的完整实现步骤：

一、创建插件扩展目录结构 #

在项目根目录下手动创建以下目录（不存在则新建）：

extensions/
└── users-permissions/
    └── server/
        ├── bootstrap/
        │   └── grant-config.js
        └── services/
            └── providers-registry.js

二、编写OAuth2配置文件（grant-config.js） #

复制原node_modules/@strapi/plugin-users-permissions/server/bootstrap/grant-config.js的完整内容，替换/添加Line的OAuth2配置：

'use strict';

const _ = require('lodash');

module.exports = ({ strapi }) => {
  const grantConfig = {
    // 保留原有Google、Facebook等其他provider配置
    line: {
      clientId: strapi.config.get('plugin.users-permissions.providers.line.clientId'),
      clientSecret: strapi.config.get('plugin.users-permissions.providers.line.clientSecret'),
      redirectUri: strapi.config.get('plugin.users-permissions.providers.line.redirectUri'),
      scope: ['profile', 'openid', 'email'], // 根据Line权限需求调整
      response_type: 'code',
      grant_type: 'authorization_code',
      authorizationURL: 'https://access.line.me/oauth2/v2.1/authorize',
      tokenURL: 'https://api.line.me/oauth2/v2.1/token',
      profileURL: 'https://api.line.me/v2/profile',
    },
  };

  const mergedGrantConfig = _.merge({}, grantConfig, strapi.config.get('plugin.users-permissions.grant', {}));
  strapi.plugins['users-permissions'].services.grant.setConfig(mergedGrantConfig);
};

三、编写用户信息获取逻辑（providers-registry.js） #

复制原node_modules/@strapi/plugin-users-permissions/server/services/providers-registry.js的完整内容，添加Line的用户信息解析逻辑：

'use strict';

const _ = require('lodash');
const fetch = require('node-fetch'); // 需先执行npm install node-fetch

module.exports = ({ strapi }) => {
  const providers = {
    // 保留原有其他provider的逻辑
    line: {
      async getProfile(accessToken) {
        const response = await fetch('https://api.line.me/v2/profile', {
          headers: { 'Authorization': `Bearer ${accessToken}` },
        });
        const profile = await response.json();

        return {
          id: profile.userId,
          username: profile.displayName,
          email: profile.email || null, // 需在Line开发者平台申请email权限才能获取
          name: profile.displayName,
        };
      },
    },
  };

  const mergedProviders = _.merge({}, providers, strapi.config.get('plugin.users-permissions.providers', {}));
  strapi.plugins['users-permissions'].services.providers.set(mergedProviders);
};

四、配置Line开发者参数 #

在项目根目录的config/plugins.js（无则新建）中添加Line的配置项：

module.exports = ({ env }) => ({
  // 保留其他插件配置
  'users-permissions': {
    config: {
      providers: {
        line: {
          clientId: env('LINE_CLIENT_ID'),
          clientSecret: env('LINE_CLIENT_SECRET'),
          redirectUri: env('LINE_REDIRECT_URI'), // 格式示例：https://your-strapi-domain.com/api/connect/line/callback
        },
      },
    },
  },
});

五、添加环境变量 #

在.env文件中填入Line开发者平台获取的凭证：

LINE_CLIENT_ID=你的Line应用Client ID
LINE_CLIENT_SECRET=你的Line应用Client Secret
LINE_REDIRECT_URI=https://your-strapi-domain.com/api/connect/line/callback

六、常见错误排查 #

• 回调地址不匹配：确保Strapi配置的redirectUri与Line开发者平台中设置的回调地址完全一致（包括HTTP/HTTPS、域名、路径）
• 无法获取邮箱：需在Line开发者平台的权限设置中开启email权限，并同步更新grant-config.js中的scope数组
• 请求失败：检查是否安装了node-fetch依赖，执行npm install node-fetch即可
• 配置不生效：修改扩展文件后必须重启Strapi服务，同时清除浏览器缓存后测试

内容的提问来源于stack exchange，提问作者Anuchall Leurachll