在better-auth中，你可以同时支持Twitter和Email两种登录方式，并且实现账户关联功能，让用户通过不同方式登录时获得相同的userId。
Better Auth将**用户(User)和账户(Account)**分离设计。一个User代表具有个人资料信息的用户，而Account代表连接到该用户的特定认证方法。 users-accounts.mdx:1-50
你需要在betterAuth配置中同时启用email认证和Twitter社交登录：
通过emailAndPassword选项启用邮箱密码登录
在socialProviders数组中添加Twitter provider配置
Twitter provider使用OAuth 2.0流程，默认请求以下权限范围：users.read、tweet.read、offline.access、users.email。 twitter.ts:107-109
Better Auth通过handleOAuthUserInfo函数实现自动账户关联： link-account.ts:41-88
账户能够自动关联需要满足以下条件： link-account.ts:48-66
emailVerified = true)trustedProviders列表中当配置完成后：
首次注册：用户可以选择邮箱注册或Twitter登录，都会创建独立的User记录和对应的Account记录
账户关联：
统一身份：无论用户通过哪种方式登录，都会获得相同的userId，确保用户数据的一致性
灵活登录：用户可以随时选择邮箱密码或Twitter任一方式登录，享受相同的用户体验
trustedProviders以简化关联流程通过这种设计，better-auth实现了多种认证方式的无缝整合，让用户享受灵活便捷的登录体验，同时保持统一的用户身份标识。
根据你的配置，你想要自定义OAuth用户信息处理，让email不使用Twitter绑定的email，而是让用户自定义。
在better-auth中，handleOAuthUserInfo是内部函数，不能直接在配置中覆盖。 link-account.ts:7-22 但你可以通过以下方式实现你的需求：
你已经在配置中使用了mapProfileToUser，可以扩展它来处理email：
export const auth = betterAuth({
// ... 其他配置
socialProviders: {
twitter: {
clientId: env.AUTH_TWITTER_ID,
clientSecret: env.AUTH_TWITTER_SECRET,
scope: [
"tweet.read",
"tweet.write",
"users.read",
"offline.access",
"media.write",
],
overrideUserInfoOnSignIn: true,
mapProfileToUser: (profile) => {
return {
userName: profile.data.username,
// 不设置email，让用户后续自定义
email: undefined, // 或者设置为临时email
};
},
},
},
// 启用账户关联但不基于email
account: {
updateAccountOnSignIn: true,
accountLinking: {
enabled: false, // 禁用自动关联
}
},
});
添加email/password认证，让用户可以设置自定义email：
import { emailAndPassword } from "better-auth/plugins";
export const auth = betterAuth({
// ... 其他配置
emailAndPassword: {
enabled: true,
requireEmailVerification: false, // 可选
},
socialProviders: {
twitter: {
// ... Twitter配置
mapProfileToUser: (profile) => {
return {
userName: profile.data.username,
// 使用临时email或不设置email
email: `temp_${profile.data.id}@twitter.local`,
};
},
},
},
plugins: [
nextCookies(),
bearer(),
emailAndPassword()
],
});
用户可以在登录后手动关联email账户： users-accounts.mdx:337-378
// 客户端代码 await authClient.linkSocial({ provider: "credential", // email/password callbackURL: "/profile" });
这种方式让用户完全控制自己的email设置，而不依赖Twitter提供的email信息。 link-account.ts:111-122
Notes
handleOAuthUserInfo函数是better-auth内部的账户关联逻辑，主要处理OAuth登录时的用户信息和账户关联。 sign-in.ts:274-292 虽然不能直接覆盖，但通过mapProfileToUser和账户关联配置可以实现类似的自定义效果。
Wiki pages you might want to explore:
Better-auth integrates email and Twitter login methods with account linking through a well-structured architecture that separates Users from Accounts, enabling multiple authentication methods to be linked to a single user profile.
Better-auth uses a User-Account separation model where Users represent individuals with profile information, while Accounts represent specific authentication methods (email/password, Twitter, etc.) linked to those users. users-accounts.mdx:1-50
The system provides dedicated API endpoints for account linking functionality:
linkSocialAccount endpoint - Initiates the OAuth flow for linking social providers like Twitter account.ts:88The account linking process follows this pattern:
The Twitter provider is implemented as a social provider that supports the account linking flow: twitter.ts:8-189
The better-auth demo shows practical account management implementation:
Account linking behavior can be configured through options: options.ts:471-495
Email authentication works as a primary account method that can have social providers linked to it.
When linking Twitter to an existing email account:
linkSocialAccount endpoint with Twitter as the providerThe linking process includes state validation and user session verification to ensure secure account linking: callback.ts:162