Firebird中UTF-8字符字段显示问号的问题排查求助

核心原因 #

虽然字段级设置了UTF8字符集，但客户端连接时未指定匹配的UTF8字符集，导致Firebird在接收数据时无法正确识别编码，将无效字节替换为问号。数据库默认字符集为NONE不影响字段级字符集，但连接字符集必须与字段字符集一致才能完成正确转码。

解决步骤 #

1. 配置客户端连接字符集 #

所有连接数据库的工具（Firebird Maestro/Flame Robin）和应用程序，必须在连接时明确指定字符集为UTF8：

• Firebird Maestro：创建/编辑连接时，在「Connection Settings」中找到「Character Set」选项，选择UTF8。
• Flame Robin：右键连接 →「Properties」→「Connection」标签页，在「Character set」下拉框中选择UTF8。
• 应用程序连接字符串示例：
  • JDBC：jdbc:firebirdsql://localhost:3050/yourdb?charSet=UTF8
  • Python（fdb库）：conn = fdb.connect(dsn='localhost:/path/to/yourdb', user='sysdba', password='masterkey', charset='UTF8')

2. 验证字段字符集配置 #

执行SQL查询确认目标字段的字符集是否正确设置为UTF8：

SELECT 
  RDB$RELATION_NAME AS TABLE_NAME,
  RDB$FIELD_NAME AS COLUMN_NAME,
  RDB$CHARACTER_SET_NAME AS CHARSET,
  RDB$COLLATION_NAME AS COLLATION
FROM RDB$RELATION_FIELDS
WHERE RDB$CHARACTER_SET_NAME IS NOT NULL
  AND RDB$RELATION_NAME = 'YOUR_TABLE_NAME' -- 替换为你的表名
ORDER BY TABLE_NAME, COLUMN_NAME;

确保目标VARCHAR字段的CHARSET值为UTF8，排序规则（如UTF8_UNICODE_CI）符合业务需求。

3. 修复已存在的错误数据 #

已存储为问号的俄文/乌克兰文数据无法直接恢复，需在连接字符集配置正确后，重新导入或输入编码正确的内容。

额外注意事项 #

• Firebird 2.5中，NONE字符集表示「无编码转换」，若连接字符集设为NONE，Firebird会直接将客户端发送的字节存入字段。但字段为UTF8时，只有客户端发送标准UTF8字节才能正确显示，无效字节会被替换为问号。
• 所有操作数据库的客户端必须统一使用UTF8连接字符集，避免混用不同字符集导致编码混乱。

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