Spring REST方法中PathVariable的配置及自定义ID类型映射异常解决

咱们一步步来解决你的问题，首先看你遇到的两个核心问题：Hibernate的映射报错，以及Spring REST里的PathVariable绑定和查询逻辑问题。

一、先解决Hibernate的主键映射报错 #

你看到的报错Could not determine type for: veranstaltung.Identificationnumber...，根源是Hibernate不知道如何把自定义的Identificationnumber类作为Teilnehmer的主键映射到数据库。因为Identificationnumber是一个复合主键（包含firstpart和secondpart），我们需要用JPA的嵌入主键机制来处理：

1. 修改Identificationnumber类，标记为可嵌入类型 #

给类添加@Embeddable注解，同时必须补充无参构造函数（JPA规范要求）：

package veranstaltung;
import javax.persistence.Embeddable;

@Embeddable
public class Identificationnumber {
    private String firstpart;
    private Long secondpart;

    // 新增无参构造函数
    public Identificationnumber() {}

    public Identificationnumber(String firstpart, Long secondpart) {
        this.firstpart = firstpart;
        this.secondpart = secondpart;
    }

    // 原有getter、setter和getfullID方法保持不变
    public String getFirstpart() { return firstpart; }
    public void setFirstpart(String firstpart) { this.firstpart = firstpart; }
    public Long getSecondpart() { return secondpart; }
    public void setSecondpart(Long secondpart) { this.secondpart = secondpart; }
    public String getfullID() { return firstpart + ' ' + secondpart; }
}

2. 修改Teilnehmer类，使用嵌入主键 #

把原来的@Id注解换成@EmbeddedId，告诉Hibernate这是一个嵌入的复合主键：

package veranstaltung;
import javax.persistence.Entity;
import javax.persistence.EmbeddedId;

@Entity
public class Teilnehmer {
    static int idnumber=69;
    @EmbeddedId
    private Identificationnumber id;
    
    // 原有字段、无参构造、带参构造、getter/setter、toString方法保持不变
    protected Teilnehmer() {}
    public Teilnehmer(Identificationnumber id, String name, String vorname,String wohnort) {
        this.id=id;
        this.name=name;
        this.vorname=vorname;
        this.wohnort=wohnort;
    }
    // ... 其他方法省略
}

这样Hibernate就能正确识别复合主键，将其映射到数据库表的firstpart和secondpart两个字段。

二、修复Controller的PathVariable和查询逻辑 #

现在主键是复合类型，你要绑定并使用secondpart变量，需要调整路径定义、参数绑定和Repository查询方法：

1. 给TeilnehmerRepository添加自定义查询方法 #

因为默认的findById需要传入完整的Identificationnumber主键，我们需要添加通过secondpart单独查询的方法：

package veranstaltung;
import org.springframework.data.jpa.repository.JpaRepository;
import java.util.Optional;

public interface TeilnehmerRepository extends JpaRepository<Teilnehmer, Identificationnumber> {
    // Spring Data JPA会根据方法名自动生成查询SQL
    Optional<Teilnehmer> findByIdSecondpart(Long secondpart);
}

2. 修改Controller方法，正确绑定secondpart #

调整请求路径为/teilnehmer/{secondpart}，并显式指定PathVariable的名称（确保和路径变量名一致），同时用更规范的ResponseEntity返回结果：

package veranstaltung;
import veranstaltung.Teilnehmer;
import veranstaltung.TeilnehmerRepository;
import java.util.Optional;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;

@RestController
public class TeilnehmerController {
    @Autowired
    TeilnehmerRepository teilnehmerRepository;

    @GetMapping("/teilnehmer")
    Iterable<Teilnehmer> teilnehmer(){
        return this.teilnehmerRepository.findAll();
    }

    @GetMapping("/teilnehmer/{secondpart}")
    ResponseEntity<Teilnehmer> teilnehmerBySecondpart(@PathVariable("secondpart") Long secondpart){
        // 使用自定义的查询方法
        Optional<Teilnehmer> teilnehmerOptional = this.teilnehmerRepository.findByIdSecondpart(secondpart);
        // 返回200（找到）或404（未找到）状态码
        return teilnehmerOptional.map(ResponseEntity::ok)
                .orElseGet(() -> ResponseEntity.notFound().build());
    }
}

关键说明 #

• 原来的路径是/teilnehmer/{id}，但参数名是secondpart，名称不匹配会导致Spring无法正确绑定变量，所以我们把路径改成/{secondpart}，并通过@PathVariable("secondpart")明确绑定，这样就能直接访问到secondpart变量。
• 用ResponseEntity替代返回null，更符合REST接口的规范，能给前端返回清晰的HTTP状态码。

额外场景：如果需要通过完整复合主键查询 #

如果你的业务需要同时传入firstpart和secondpart来查询，可以把路径改成/teilnehmer/{firstpart}/{secondpart}，Controller方法调整为：

@GetMapping("/teilnehmer/{firstpart}/{secondpart}")
ResponseEntity<Teilnehmer> teilnehmerById(
        @PathVariable String firstpart, 
        @PathVariable Long secondpart){
    Identificationnumber id = new Identificationnumber(firstpart, secondpart);
    Optional<Teilnehmer> teilnehmerOptional = this.teilnehmerRepository.findById(id);
    return teilnehmerOptional.map(ResponseEntity::ok)
            .orElseGet(() -> ResponseEntity.notFound().build());
}

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