NuxtJS Auth Docker运行时动态配置端点仍请求默认接口

DevOps 小满

2026-8-29

问题原因

环境变量使用逻辑错误：NUXT_ENV_ 前缀的环境变量为构建时静态注入，会在nuxt build执行阶段被直接替换为构建时的取值，构建完成后产出的代码中该值已被静态写死，容器启动时传入的运行时同名变量不会被读取，这也是最初直接在nuxt.config.js的auth配置中拼接变量得到/user/undefined的核心原因。
配置修改时机与方式错误：在普通全局插件中直接修改$auth.strategies.local.options.endpoints，仅会修改模块对外暴露的配置属性，此时Nuxt Auth模块已经完成策略初始化，内部请求逻辑已经固化了初始端点配置（由于初始未配置user端点，模块自动回退到默认路径api/auth/user），后期修改options对象不会同步更新实际请求使用的地址。

修复方案

调整环境变量规则
去掉环境变量的NUXT_ENV_前缀，运行时动态传入的环境变量使用普通命名，通过Nuxt RuntimeConfig机制读取，不再依赖构建时注入的NUXT_ENV_变量。Docker启动容器时传入COMMUNITY_ID即可，不需要在构建阶段传入该值。
调整nuxt.config.js配置
将auth相关插件从全局plugins数组移到auth模块自身的plugins配置项中，保证插件在auth模块初始化策略的阶段执行，同时给user端点设置初始占位避免触发默认值逻辑，示例配置：

auth: {
  redirect: {
    home: '/home'
  },
  strategies: {
    local: {
      endpoints: {
        login: {url: "/login", method: "post"},
        logout: {url: "/logout", method: "post"},
        user: {url: "", method: "GET"} // 初始占位，避免触发默认端点规则
      },
      token: {
        property: 'token',
        global: true,
        maxAge: 14400,
      },
      redirectUri: undefined,
    }
  },
  // auth专属插件在此注册，执行时机早于全局插件，在策略初始化阶段运行
  plugins: [{ src: '~/plugins/auth', ssr: true }],
},
// 移除外层全局plugins中注册的auth插件，避免重复执行
publicRuntimeConfig: {
  communityId: process.env.COMMUNITY_ID // 自动读取运行时传入的COMMUNITY_ID
},
privateRuntimeConfig: {
  communityId: process.env.COMMUNITY_ID
},
// 可移除原有的env配置块，runtimeConfig已覆盖运行时变量读取能力

修改auth插件的配置更新方式
不要直接赋值修改options属性，调用Nuxt Auth官方提供的extendStrategies方法更新策略配置，该方法会同步刷新模块内部请求逻辑使用的端点值，示例代码：

export default function({ $auth, $config }) {
  $auth.extendStrategies({
    local: {
      endpoints: {
        user: {
          url: `/user/${$config.communityId}`,
          method: 'GET'
        }
      }
    }
  })
}

配置修改后重新构建一次镜像，后续启动容器时只需要传入不同的COMMUNITY_ID环境变量，就能自动生成对应的user请求端点，不需要针对每个场景单独构建镜像。

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