PostgreSQL中存储OAuth2 Access Token时text/varchar自动转数字的问题

核心原因 #

• 90%以上是应用层类型映射错误：你的ORM框架（比如MyBatis、Hibernate）或者数据访问代码里，把Access Token对应的字段错误映射成了数值类型（Long/Integer），而非字符串类型。MySQL对类型隐式转换的兼容度更高，所以没暴露问题，但PostgreSQL类型校验更严格，框架会自动把字符串转成数字存入，导致Token丢失或变样。
• 极小概率是数据库端的触发器/约束：比如字段设置了自动转换的触发器，但这种情况换text/varchar类型后仍出现问题的可能性极低。

解决步骤 #

1. 检查实体类字段类型：确保存储Access Token的字段是String类型，比如Java中要定义成private String accessToken;，绝对不能是数值类型。
2. 核对ORM映射配置：
   • 用MyBatis的话，检查XML映射文件里的parameterType/resultType是否为string，字段映射是否正确。
   • 用JPA的话，确认@Column注解的columnDefinition是TEXT或VARCHAR，且实体类字段类型和数据库字段类型匹配。
3. 排查插入前的代码逻辑：在插入数据库前，打印待存入的Token值和它的类型，确认数据没有被提前转换。比如加一行日志：

   System.out.println("准备存入的Token：" + accessToken + "，类型：" + accessToken.getClass().getName());
   

4. 直接数据库插入测试：跳过应用层，用SQL语句直接插入测试Token到对应字段，比如：

   INSERT INTO your_table (access_token) VALUES ('eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c');
   

   如果直接插入后数据库显示正常，那100%是应用层的类型映射问题。

内容的提问来源于stack exchange，提问作者Shehab El Basmy