Helidon端点调用报错：No handler found for path: /sampleString求助

问题重现 #

你的端点代码：

@GET
@Path("/sampleString")
@Produces(MediaType.APPLICATION_JSON)
public Message getSampleString() {
    return "{'Sample':'String'}";
}

调用curl -i http://localhost:8080/sampleString时收到报错：

No handler found for path: /sampleString

核心原因与修复方案 #

1. 资源类缺少类级别@Path注解

Helidon的JAX-RS资源必须在类级别标注@Path，方法级别的@Path是类路径的子路径。如果类没有@Path，容器无法识别这是一个可注册的资源端点。

修复示例：

// 类级别添加@Path，基础路径可自定义（比如"/api"）
@Path("/")
public class SampleResource {
    @GET
    @Path("/sampleString")
    @Produces(MediaType.APPLICATION_JSON)
    public String getSampleString() {
        // JSON规范要求使用双引号，替换单引号避免格式错误
        return "{\"Sample\":\"String\"}";
    }
}

2. 资源类未被Helidon应用注册

如果资源类未被自动扫描到，需要手动在应用构建时注册：

Helidon SE场景

在启动类中手动注册资源：

public class Main {
    public static void main(final String[] args) {
        WebServer.create(Config.create(), buildRouting())
                .start()
                .thenAccept(server -> 
                    System.out.println("Server running at http://localhost:" + server.port())
                );
    }

    private static Routing buildRouting() {
        return Routing.builder()
                .register(JsonSupport.create())
                .register(new SampleResource()) // 注册你的资源类
                .build();
    }
}

Helidon MP场景

确保资源类在CDI扫描范围内，可添加@RequestScoped注解让容器自动发现：

@Path("/")
@RequestScoped
public class SampleResource {
    // 端点方法...
}

3. 额外修正：返回值类型与JSON格式

你的方法声明返回Message但实际返回字符串，会导致运行时类型错误。若要返回自定义对象，需创建对应的实体类并确保能被JSON序列化：

// 定义Message实体类
public class Message {
    private String sample;

    public Message() {} // 需提供无参构造用于序列化

    public Message(String sample) {
        this.sample = sample;
    }

    // Getter和Setter
    public String getSample() { return sample; }
    public void setSample(String sample) { this.sample = sample; }
}

修正后的端点方法：

@GET
@Path("/sampleString")
@Produces(MediaType.APPLICATION_JSON)
public Message getSampleString() {
    return new Message("String");
}

内容的提问来源于stack exchange，提问作者Günter Brilowski