如何实现Parse Server用户名不区分大小写的登录功能？

为什么你的云函数没生效 #

你定义的login云函数未被触发，核心原因是客户端调用的是Parse原生的/login接口，而非云函数对应的/functions/login接口。Parse原生登录逻辑由内部处理，不会自动调用同名云函数。

方案一：修改客户端调用云函数（快速生效） #

如果允许调整客户端代码，直接改用云函数调用即可。修改KMP的登录请求定义：

@POST("functions/login")
@Headers(
    value = [
        "${ParseHeaders.CONTENT_TYPE}: application/json",
        "${ParseHeaders.APPLICATION_ID}: ${ParseConstants.APPLICATION_ID}",
        "${ParseHeaders.REST_API_KEY}: ${ParseConstants.REST_API_KEY}",
    ],
)
suspend fun logInViaCloud(@Body params: Map<String, String>): ParseCloudResponse<ParseUserResponse>

调用时传递处理后的用户名（服务端也可再做一次转小写，确保一致性）：

val params = mapOf(
    "username" to credentials.username.toLowerCase(),
    "password" to credentials.password
)
val response = logInViaCloud(params)

方案二：使用Parse Server的beforeLogin钩子（无需修改客户端） #

这是最推荐的方案——通过登录前置钩子拦截原生登录请求，手动处理用户名大小写匹配逻辑，完全在服务端解决问题。

在云代码中添加以下钩子：

Parse.Cloud.beforeLogin(async (request) => {
  const { username, password } = request.params;
  if (!username || !password) {
    throw new Parse.Error(101, "用户名或密码不能为空");
  }

  // 方式1：用正则实现不区分大小写查询（需配合索引优化性能）
  const query = new Parse.Query(Parse.User);
  query.equalTo("username", new RegExp(`^${username}$`, "i"));

  // 方式2：用MongoDB collation查询（性能更优，推荐）
  // query._query.collation({ locale: "en", strength: 2 });
  // query.equalTo("username", username);

  const matchedUser = await query.first({ useMasterKey: true });
  if (!matchedUser) {
    throw new Parse.Error(101, "登录错误");
  }

  // 手动验证密码
  const isPasswordValid = await matchedUser.verifyPassword(password);
  if (!isPasswordValid) {
    throw new Parse.Error(101, "登录错误");
  }

  // 将匹配到的用户赋值给request.user，覆盖原生登录逻辑
  request.user = matchedUser;
});

配套性能优化： #

若使用正则查询，需给_User集合的username字段创建不区分大小写的索引，避免全表扫描：

// 在MongoDB Shell中执行
db._User.createIndex(
  { username: 1 },
  { collation: { locale: 'en', strength: 2 }, unique: true }
);

strength:2表示忽略大小写和重音，适配大多数场景；若需支持其他语言，调整locale参数即可。

方案三：MongoDB端统一用户名存储格式（可选） #

为避免后续新用户的用户名格式混乱，可添加beforeSave钩子，强制新用户的用户名转小写存储：

Parse.Cloud.beforeSave(Parse.User, async (request) => {
  const user = request.object;
  // 仅在创建新用户或修改用户名时处理
  if (user.isNew() || user.dirty("username")) {
    const lowercaseUsername = user.get("username").toLowerCase();
    // 检查小写用户名是否已存在
    const duplicateQuery = new Parse.Query(Parse.User);
    duplicateQuery.equalTo("username", lowercaseUsername);
    const existingUser = await duplicateQuery.first({ useMasterKey: true });
    if (existingUser && existingUser.id !== user.id) {
      throw new Parse.Error(202, "用户名已存在");
    }
    user.set("username", lowercaseUsername);
  }
});

该方案可配合登录钩子，既兼容历史混乱数据，又能规范新数据格式。

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