ServiceStack v5.02问题：AutoQuery视图/类未自动显示在Admin View中

我之前在ServiceStack v5.x版本里也碰到过一模一样的情况，AutoQuery的查询服务死活没出现在Admin UI里，给你几个实际踩坑后总结的排查和解决步骤：

1. 先确认AutoQueryFeature是否正确注册 #

这是最容易忽略的核心点——如果没在AppHost里注册AutoQuery插件，Admin UI根本识别不了AutoQuery服务。打开你的AppHost配置类，检查Configure方法里有没有这段代码：

Plugins.Add(new AutoQueryFeature { MaxLimit = 1000 }); // 参数可以根据你的需求调整

要是没有，加上它再重启应用，这大概率能直接解决问题。

2. 检查Query类和实体类的定义规范 #

你的QueryCustomers继承QueryDb<Customer>是正确的，但可以额外确认两点：

• 确保QueryCustomers是公共类，而且没有被[Exclude(Feature.Metadata)]这类属性标记（这类属性会把服务从元数据和Admin UI里彻底隐藏）
• 检查Customer实体类的属性都是公共可读写的，Admin UI依赖元数据生成界面，只读属性或者非公共属性可能会影响识别

3. 排查AdminFeature的自定义配置 #

如果你的项目自定义了AdminFeature的设置，要确保没把AutoQuery服务排除在外。比如：

Plugins.Add(new AdminFeature {
    // 注意不要用ExcludeServices排除AutoQuery相关类型
    // ExcludeServices = { typeof(QueryDb<>) }
    // 如果需要，也可以显式包含你的查询服务
    IncludeServices = { typeof(QueryCustomers) }
});

4. 刷新元数据缓存 #

ServiceStack会缓存服务元数据，有时候缓存没更新会导致Admin UI不显示新添加的服务。你可以：

• 直接重启应用（最稳妥的方式）
• 访问/metadata/reload端点（需要有足够权限）强制刷新元数据

额外验证小技巧 #

先访问/metadata端点看看：

• 如果元数据里能找到QueryCustomers服务，那问题出在Admin UI的配置或缓存，回到上面的步骤排查
• 如果元数据里也没有，说明服务根本没被注册，重点检查AutoQueryFeature的注册和Query类的定义

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