Java客户端向PostgreSQL插入复合类型报错：字符(1)类型值过长

报错的核心原因是你手动在toString()里给字符串和字符字段添加了单引号，PostgreSQL会将带单引号的内容直接当作字段值。比如'a'会被识别为长度为3的字符串（包含前后两个单引号），这显然超过了CHAR(1)的长度限制，导致报错。

另外，直接依赖toString()来生成复合类型的字符串表示是不可靠的，一旦字段值包含特殊字符（比如单引号、逗号），还会引发其他语法错误。

推荐以下几种可行的解决方式：

方式一：快速修正toString格式（临时方案） #

去掉手动添加的单引号，让PostgreSQL自动处理类型转换：

@Override
public String toString() {
    return String.format("(%d, %d, %s, %b, %c)",
        this.getId(), 
        this.getOtherId(),
        this.getName(),
        this.getIsTrue(),
        this.getSomeChar());
}

注意：这种方式仅适用于字段值不包含特殊字符（如逗号、单引号）的场景，否则会引发语法错误。

方式二：使用PGobject规范处理（PostgreSQL专属推荐） #

通过PostgreSQL JDBC提供的PGobject来包装复合类型，避免手动拼接字符串的问题：

1. 实现MyType到PGobject的转换：

import org.postgresql.util.PGobject;

public PGobject toPGobject() throws SQLException {
    PGobject pgObject = new PGobject();
    pgObject.setType("my_type");
    // 正确构造复合类型的字符串表示，无需手动加引号，特殊字符由驱动自动处理
    String value = String.format("(%d, %d, %s, %b, %c)",
        this.getId(),
        this.getOtherId(),
        this.getName(),
        this.getIsTrue(),
        this.getSomeChar());
    pgObject.setValue(value);
    return pgObject;
}

2. 插入时传入PGobject数组：

// 将MyType列表转换为PGobject数组
PGobject[] pgObjects = model.getMyTypes().stream()
    .map(myType -> {
        try {
            return myType.toPGobject();
        } catch (SQLException e) {
            throw new RuntimeException(e);
        }
    })
    .toArray(PGobject[]::new);

statement.setObject(4, c.createArrayOf("my_type", pgObjects));

方式三：使用JDBC标准Struct类型（通用兼容方案） #

如果希望遵循JDBC标准，不依赖PostgreSQL特定类，可以使用Struct：

1. 转换MyType为Struct：

Struct toStruct(Connection conn) throws SQLException {
    Object[] attributes = new Object[]{
        this.getId(),
        this.getOtherId(),
        this.getName(),
        this.getIsTrue(),
        this.getSomeChar()
    };
    return conn.createStruct("my_type", attributes);
}

2. 插入时传入Struct数组：

Struct[] structs = model.getMyTypes().stream()
    .map(myType -> {
        try {
            return myType.toStruct(c);
        } catch (SQLException e) {
            throw new RuntimeException(e);
        }
    })
    .toArray(Struct[]::new);

statement.setObject(4, c.createArrayOf("my_type", structs));

这种方式完全遵循JDBC标准，兼容性更好，无需额外引入PostgreSQL专属依赖。

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