Heroku部署Strapi v4覆盖users-permissions插件遇jwtSecret问题求助

云上老周

2026-6-26

Strapi v4 覆盖 users-permissions 控制器及 Heroku JWT_SECRET 问题解决建议

一、解决Heroku上的JWT_SECRET错误

直接在Heroku的环境变量面板中添加JWT_SECRET，值用随机生成的长字符串（可通过openssl rand -hex 32命令生成）。Strapi v4优先读取环境变量，本地运行正常是因为Strapi会自动生成该变量，而Heroku环境未自动生成导致报错。
不要复制整个插件文件夹进行覆盖，这会引发配置加载冲突，是导致JWT配置无效的核心原因之一。

二、正确覆盖auth.js和user.js控制器

Strapi v4支持按需覆盖插件文件，无需复制全部内容，步骤如下：

在项目根目录创建路径src/extensions/users-permissions/controllers/（不存在则手动创建）。

在该路径下创建auth.js和user.js，通过导入原控制器并扩展方法实现覆盖，示例代码如下：

// src/extensions/users-permissions/controllers/auth.js
const { createCoreController } = require('@strapi/strapi').factories;

module.exports = createCoreController('plugin::users-permissions.auth', ({ strapi }) => ({
  // 示例：覆盖登录方法
  async login(ctx) {
    // 执行原控制器的登录逻辑
    const { data, meta } = await super.login(ctx);
    // 添加自定义逻辑
    data.custom_field = '自定义内容';
    return { data, meta };
  },

  // 可按需添加或覆盖其他方法
}));

// src/extensions/users-permissions/controllers/user.js
const { createCoreController } = require('@strapi/strapi').factories;

module.exports = createCoreController('plugin::users-permissions.user', ({ strapi }) => ({
  // 示例：覆盖获取用户信息方法
  async findOne(ctx) {
    const response = await super.findOne(ctx);
    // 自定义修改返回数据
    response.data.attributes.avatar_url = strapi.config.get('server.url') + response.data.attributes.avatar.url;
    return response;
  }
}));