Restlet Framework原生镜像访问资源出现405错误求助

我用Restlet框架结合GraalVM原生镜像开发项目，通过Maven命令mvn clean package -Pnative-image成功构建了原生镜像，服务器启动正常，但用HTTP客户端访问/hello资源时返回405错误，对应的JUnit测试却是通过的。

简化后的代码与配置 #

Main.java #

// ... imports ...

public class Main extends Application{

    private static final int HTTP_PORT = 8080;

    public static void main(final String[] args) throws Exception {
        Component component = new Component();
        component.getServers().add(Protocol.HTTP, HTTP_PORT);
        component.getDefaultHost().attach("", new Main());
        component.start();
    }

    @Override
    public Restlet createInboundRoot() {
        Router router = new Router(getContext());
        router.attach("/hello", HelloWorldResource.class);
        return router;
    }
}

HelloWorldResource.java #

// ... imports ... 

public class HelloWorldResource extends ServerResource {
    private String name;

    @Override
    protected void doInit() throws ResourceException {
        this.name = getQueryValue("name");
        if (this.name == null) {
            this.name = "world";  
        }
    }

    @Get
    public String sayHello() {
        return "hello, " + this.name;
    }
}

pom.xml相关配置 #

1. native-image-maven-plugin配置

<buildArgs>
    <!-- Fail when can't build successfully -->
    <buildArg>--no-fallback</buildArg>
    <!-- Max heap limit -->
    <buildArg>-J-Xmx16g</buildArg>
    <!-- Include all resources -->
    <buildArg>-H:IncludeResources=.*\.*$</buildArg>
    <buildArg>-H:+AllowIncompleteClasspath</buildArg>
    <buildArg>-H:ReflectionConfigurationFiles=${project.build.directory}/classes/META-INF/native-image/reflect-config.json</buildArg>
</buildArgs>

2. Surefire插件配置

<!--
    Surefire Plugin: Configures the test runner for the build.
        Added to create the JSON configuration files automatically 
        on tests.
-->
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>2.20.1</version>
    <configuration>
        <argLine>
            -agentlib:native-image-agent=config-output-dir=target/classes/META-INF/native-image
        </argLine>
    </configuration>
</plugin>

排查思路与建议 #

• 检查反射配置完整性：GraalVM原生镜像需要明确配置反射才能识别Restlet的注解（比如@Get）。虽然用了native-image-agent生成配置，但可能测试覆盖不全，导致@Get注解的处理逻辑没被捕获。手动检查reflect-config.json，确认是否包含HelloWorldResource的sayHello方法、@Get注解类的反射配置，以及Restlet内部处理注解的相关类（比如AnnotationUtils、ServerResource子类处理逻辑）。
• 添加Restlet原生镜像支持依赖：Restlet有专门针对GraalVM的适配依赖（如org.restlet.ext.graalvm），确保pom.xml中引入了对应依赖包，版本与Restlet主版本匹配。
• 禁用AllowIncompleteClasspath：当前配置的-H:+AllowIncompleteClasspath会忽略类路径缺失问题，可能导致Restlet核心类未被正确纳入原生镜像。尝试移除该参数，重新构建看是否有类缺失报错，再针对性补充依赖或配置。
• 验证请求方法：确认HTTP客户端发送的是GET请求，405表示方法不允许，有可能误发了POST/PUT等其他方法。另外可在HelloWorldResource中重写options方法，打印支持的请求方法，确认是否包含GET。
• 开启Restlet调试日志：原生镜像启动时添加日志参数（如-Dorg.restlet.engine.logger.level=FINE），查看请求路由详细日志，确认/hello资源是否被正确映射、请求方法是否被正确识别。
• 检查构建警告：重新执行mvn clean package -Pnative-image，仔细查看输出中的警告信息，尤其是类、方法未注册到反射/资源配置的提示，这些往往是问题根源。

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