Solidtime用户创建与登录问题排查与解决方案

问题背景

在使用Solidtime开源项目进行自托管部署时，用户反馈了一个关于新创建用户无法登录的问题。具体表现为：通过命令行工具创建新用户后，使用相同的凭据在Web界面登录时，系统提示"These credentials do not match our records"（这些凭据与我们的记录不匹配）。

问题复现与分析

通过详细的技术排查，我们重现了该问题的完整流程：

1. 用户执行了完整的清理操作，包括停止容器、删除相关存储卷
2. 重新启动所有服务后，使用artisan命令创建新用户
3. 创建用户时使用了包含大写字母的邮箱地址（如"[e-mail]"）
4. 服务重启后尝试使用该邮箱登录失败

深入分析发现，问题的根源在于系统对邮箱地址的大小写处理不一致：

• 用户创建命令(admin:user:create)直接使用原始输入的邮箱地址，未进行规范化处理
• 而登录系统在处理邮箱地址时，会将其转换为全小写形式进行比对
• 这种不一致导致数据库中存储的邮箱与登录时处理的邮箱不匹配

技术解决方案

针对这一问题，我们建议采取以下解决方案：

临时解决方案

对于当前遇到问题的用户，可以采取以下临时措施：

1. 使用全小写字母的邮箱地址重新创建用户
2. 例如将"[e-mail]"改为"[e-mail]"

长期修复方案

从代码层面，我们需要进行以下改进：

1. 在用户创建命令中增加邮箱地址规范化处理
2. 确保所有涉及邮箱比较的操作都使用统一的大小写处理逻辑
3. 添加数据库迁移脚本，修复已存在的不规范邮箱记录

最佳实践建议

为了避免类似问题，我们建议开发者和系统管理员：

1. 始终使用全小写格式存储和比较邮箱地址
2. 在用户输入环节就对邮箱地址进行规范化处理
3. 实现统一的用户身份验证逻辑层，避免分散处理导致的逻辑不一致

总结

这个案例展示了在用户认证系统中处理标识符时一致性的重要性。邮箱地址作为用户身份的关键标识符，其处理方式必须在整个系统中保持统一。通过这次问题的排查和解决，我们不仅修复了一个具体的bug，也为系统的健壮性提供了保障。

对于正在使用Solidtime项目的开发者，建议关注后续的版本更新，以获取包含此问题修复的稳定版本。同时，在自定义开发过程中，也应注意类似的身份认证一致性问题。