SQLAdmin中列排序功能的正确使用方式

SQLAdmin是一个基于SQLAlchemy的Django风格管理界面框架，它提供了方便的模型管理功能。在使用过程中，开发者可能会遇到列排序配置的问题，特别是关于column_default_sort和column_sortable_list这两个重要参数的使用。

问题背景

在SQLAdmin的早期版本中，column_default_sort参数支持直接使用模型类属性作为排序依据，例如User.email这样的形式。然而在某个版本更新后，框架内部开始对排序参数调用split()方法，导致非字符串类型的参数会引发错误。

当前解决方案

目前正确的使用方式是采用字符串形式指定列名：

class UserAdmin(ModelView, model=User):
    column_default_sort = [("email", True), ("name", False)]

这种方式虽然能够正常工作，但存在一些缺点：

1. 失去了IDE的自动补全和类型检查支持
2. 列名拼写错误无法在开发阶段被及时发现
3. 重构模型时无法自动更新这些字符串引用

技术实现分析

从技术实现角度看，SQLAdmin内部需要对排序参数进行字符串处理，这是为了支持更复杂的排序表达式，比如包含表名前缀或多列组合排序等情况。split()方法的调用是为了解析这些表达式。

最佳实践建议

1. 明确使用字符串形式：在当前版本中，坚持使用字符串形式的列名是最稳妥的做法

2. 考虑添加验证逻辑：可以编写自定义验证函数，确保字符串形式的列名确实存在于模型中

3. 关注框架更新：开发者社区已经注意到这个问题，未来版本可能会恢复对模型属性的支持或提供更好的替代方案

4. 统一代码风格：在整个项目中保持一致的排序参数写法，避免混用不同形式

扩展思考

这个问题实际上反映了ORM框架中常见的"字符串vs模型属性"的权衡。字符串形式更灵活但缺乏安全性，模型属性形式更安全但可能限制某些高级用法。SQLAdmin作为管理界面框架，需要在易用性和灵活性之间找到平衡点。

对于需要频繁调整排序功能的项目，可以考虑封装一个辅助函数，将模型属性自动转换为字符串形式，既保持开发便利性又兼容框架要求。