使用okta-auth-js出现window未定义错误的解决问询

问题重现 #

[okta-auth-sdk] WARN: Memory storage can only support simple single user use case on server side, please provide custom storageProvider or storageKey if advanced scenarios need to be supported.
file:///C:/Users/.../Documents/Workspace/okta/node_modules/@okta/okta-auth-js/esm/node/oidc/util/loginRedirect.js:41
if (!isRedirectUri(window.location.href, sdk)) {
^
ReferenceError: window is not defined
at isLoginRedirect (file:///C:/Users/.../Documents/Workspace/okta/node_modules/@okta/okta-auth-js/esm/node/oidc/util/loginRedirect.js:41:24)
at OktaAuth.start (file:///C:/Users/.../Documents/Workspace/okta/node_modules/@okta/okta-auth-js/esm/node/OktaAuth.js:230:25)
at async file:///C:/Users/.../Documents/Workspace/okta/up-front.mjs:13:1

切换ESM/CommonJS格式无法解决问题，核心原因是错误调用了浏览器端专属API，且未适配Node环境的存储规则。

解决方案 #

1. 移除authClient.start()和authClient.stop()方法 #

start()是okta-auth-js为浏览器端重定向授权流程设计的初始化方法，而你在Node.js中使用的是密码凭证授权（signInWithCredentials），完全不需要这个方法——这正是触发window is not defined报错的直接原因。

2. 适配Node环境的存储配置 #

警告提示内存存储仅支持单用户场景，根据你的业务需求选择以下配置：

• 单用户场景：设置storageKey消除警告
• 多用户场景：自定义存储提供者

修改后的ESM代码 #

import * as okta from '@okta/okta-auth-js';
const authClient = new okta.OktaAuth({
    issuer: 'https://.../oauth2/.../default',
    clientId: '...',
    clientSecret: '...',
    scopes: ['license:write'],
    // 单用户场景配置storageKey消除警告
    storageKey: 'okta-server-single-user',
    // Node环境无需cookie配置，直接移除
});

// 直接调用授权方法，无需start/stop
const result = await authClient.signInWithCredentials({
    username: '...',
    password: '...'
});
console.log(result);

修改后的CommonJS代码 #

const { OktaAuth } = require('@okta/okta-auth-js');
const authClient = new OktaAuth({
    issuer: 'https://.../oauth2/.../default',
    clientId: '...',
    clientSecret: '...',
    scopes: ['license:write'],
    storageKey: 'okta-server-single-user',
});

authClient.signInWithCredentials({
    username: '...',
    password: '...'
}).then(result => {
    console.log(result);
}).catch(err => {
    console.error(err);
});

多用户场景自定义存储示例 #

如果服务需要支持多用户，可自定义存储逻辑（比如用Map实现）：

const userStorage = new Map();

const authClient = new okta.OktaAuth({
    // 其他基础配置...
    storageProvider: {
        getItem: (key) => userStorage.get(key),
        setItem: (key, value) => userStorage.set(key, value),
        removeItem: (key) => userStorage.delete(key),
        clear: () => userStorage.clear()
    }
});

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