在 filament 中使用 postgresql 搜索混合大小写字段名时，必须将字段名用双引号包裹以保留其原始大小写，否则 postgresql 会将其强制转换为小写导致列不存在错误。具体做法是在 filament 的 searchable 或 table 组件配置中，通过 searchquery() 方法自定义查询逻辑，或者在模型中定义 globalsearch() 时显式引用带引号的列名。postgresql 默认将未加引号的标识符转为小写，因此对于创建表时使用双引号定义的混合大小写字段（如 username），所有查询都必须使用双引号。
Searchable 组件如何指定精确的大小写敏感列
当在 Filament 表格中使用 Searchable() 时，默认行为可能无法正确处理 PostgreSQL 中已存在的双引号字段。解决方法是重写模型的 getTableQuery() 或使用 searchQuery() 回调来确保 SQL 生成器正确转义列名。通常，如果字段在数据库 schema 中定义为 "UserName"，Filament 的 Eloquent 查询构建器会自动处理引号，但在使用原生 SQL 片段或特定搜索逻辑时需小心。最直接的方式是利用 Eloquent 的属性映射，确保 PHP 代码中的属性名与数据库列名一致，并在搜索时让 Eloquent 处理引号。
use Filament\Tables\Columns\TextColumn;
use Filament\Tables\Table;
use Illuminate\Database\Eloquent\Model;
class User extends Model
{
protected $table = 'users';
// 假设数据库列名为 "UserName" (混合大小写)
protected $attributes = [
'UserName' => null,
];
public function getTable(Table $table): Table
{
return $table
->columns([
TextColumn::make('UserName')
->searchable(query: function ($query, string $search) {
// 关键：使用 DB::raw 或确保列名被正确引用
// 在 PostgreSQL 中，如果列名是混合大小写，必须用双引号
$query->whereRaw('"UserName" ILIKE ?', ["%{$search}%"]);
}),
]);
}
}
上述代码展示了如何在 TextColumn 的 searchable 方法中使用 whereRaw 并手动添加双引号来匹配 PostgreSQL 的混合大小写字段 UserName。这种方式绕过了 Eloquent 默认的列名推断，直接控制生成的 SQL，确保查询不会因大小写转换而失败。运行此代码后，搜索功能将正确作用于 UserName 列，而不是错误的 username 列。
全局搜索 globalSearch() 中的大小写处理策略
对于 Filament 面板的全局搜索框，需要覆盖模型的 globalSearch() 方法。在此方法中，同样需要针对 PostgreSQL 的混合大小写字段进行特殊处理。可以通过遍历模型的填充属性，检查哪些列需要大小写敏感的搜索，并应用相应的 whereRaw 条件。这种方法确保了无论用户在全局搜索框输入什么，系统都能准确地在指定的混合大小写字段中进行检索，而不会受到 PostgreSQL 默认小写转换的影响。
public static function globalSearch(string $search): \Illuminate\Database\Eloquent\Builder|null
{
return static::query()
->where(function ($query) use ($search) {
// 假设 UserName 是需要搜索的混合大小写字段
$query->whereRaw('"UserName" ILIKE ?', ["%{$search}%"])
->orWhere('email', 'ILIKE', "%{$search}%"); // 其他小写字段可直接使用
});
}
该代码片段演示了如何在 globalSearch 中结合使用 whereRaw 和标准 where。对于 UserName 这种混合大小写字段，使用 whereRaw 并显式添加双引号；而对于其他全小写字段（如 email），则可以直接使用 Eloquent 的标准方法，因为 PostgreSQL 会将它们视为小写。这种混合策略既保证了兼容性，又提高了代码的可读性和执行效率。预期结果是，全局搜索能同时命中 UserName 和 email 字段，且不会报错。
PostgreSQL 中双引号字段的实际查询行为验证
为了验证上述方法的有效性，可以创建一个简单的测试场景。在 PostgreSQL 中创建一个包含混合大小写字段的表，例如 CREATE TABLE test_table ("MixedCaseField" VARCHAR(50));。然后，使用 Filament 的应用程序尝试搜索该字段。如果直接使用 where('MixedCaseField', ...)，Eloquent 可能会生成 WHERE "mixedcasefield"...，导致找不到列。而使用 whereRaw('"MixedCaseField" ILIKE ?', ...) 则会生成正确的 SQL。通过对比这两种方式的执行结果，可以确认手动添加双引号的必要性。此外，还可以检查数据库日志，观察生成的 SQL 语句，确保双引号被正确包含在内。
