Rustical日历服务中OIDC用户创建日历问题的技术分析

Rustical日历服务中OIDC用户创建日历问题的技术分析

问题背景

Rustical是一款新兴的日历服务应用，作为传统CalDav解决方案的现代替代品，它特别提供了对OIDC(OpenID Connect)协议的支持。在实际部署中，有用户反馈在使用Authelia作为OIDC提供商时，虽然用户登录功能正常，但无法创建新的日历。

问题现象

当用户尝试通过界面创建新日历时，系统日志中会出现以下警告信息：

WARN http-request{otel.name=MKCOL /caldav/%20principal%20/%20(USERNAME_REDACTED)/workcal ua=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36 status=404 Not Found}: rustical::app: client error

技术分析

1. URL编码问题：从日志中可以看到，请求路径中包含了%20这样的URL编码空格字符，这表明原始路径中可能存在不应有的空格。

2. 前端组件问题：经过项目维护者检查，发现问题的根源在于前端创建日历表单组件中，自动格式化工具在某个时间点引入了不应存在的空格字符。

3. HTTP方法：请求使用了MKCOL(Make Collection)方法，这是WebDAV协议中用于创建集合(在日历服务中通常对应日历)的标准方法。

4. 影响范围：这个问题主要影响使用OIDC认证的用户，特别是在与Authelia集成时创建新日历的场景。

解决方案

项目维护者已经确认了修复方案，计划通过以下方式解决问题：

1. 修正前端创建日历表单组件中的空格问题
2. 确保URL路径构造时正确处理空格和特殊字符
3. 加强相关功能的测试覆盖

技术启示

1. 自动格式化的风险：这个案例展示了自动格式化工具可能引入难以察觉的问题，特别是在处理URL和路径时。

2. OIDC集成注意事项：在使用OIDC认证时，需要特别注意用户路径和权限的处理方式。

3. 日志分析的重要性：通过详细分析请求日志，可以快速定位到URL构造问题这类难以通过界面直接发现的问题。

总结

Rustical作为新兴的日历服务，在提供现代化认证方式的同时，也不可避免会遇到一些集成问题。这次的问题展示了在开发过程中需要特别注意URL构造和自动格式化工具的影响。项目维护者的快速响应也体现了开源社区解决问题的效率。

对于使用Rustical和类似服务的开发者来说，这个案例提醒我们在集成第三方认证服务时，需要全面测试所有功能流程，而不仅仅是认证环节本身。