Quarkus中SmallRye OpenAPI如何通过application.properties配置servers属性

这个需求完全可以实现，你之前配置失效是因为使用了错误的配置键，servers属于MicroProfile OpenAPI规范定义的标准可配置项，不需要加SmallRye扩展前缀，正确配置步骤如下：

步骤1：清理代码中的注解配置（可选但推荐） #

建议先移除@OpenAPIDefinition注解中硬编码的servers配置，避免和配置文件内容冲突，修改后的注解示例：

@OpenAPIDefinition(
            info = @Info(
                    description = "Description of my interface",
                    title = "Title of my interface",
                    version = ".",
                    contact = @Contact(
                            name = "Some name",
                            email = "some email")
            ))
public class MyApplication extends Application {}

步骤2：在application.properties中添加servers配置 #

单服务地址配置 #

如果只需要配置一个服务入口，直接使用如下配置即可：

mp.openapi.servers=https://dummy2

多服务地址配置（支持自定义描述） #

如果需要配置多个环境的服务入口，可以使用带自定义标识的配置格式：

# 生产环境服务地址
mp.openapi.servers.prod.url=https://prod.example.com
mp.openapi.servers.prod.description=生产环境访问入口
# 测试环境服务地址
mp.openapi.servers.test.url=https://test.example.com
mp.openapi.servers.test.description=测试环境访问入口

其中prod、test是自定义的服务标识，可根据需求自行修改。

多环境适配配置 #

配合Quarkus的profile机制，可以实现不同环境自动加载对应服务地址：

# 生产环境配置
%prod.mp.openapi.servers=https://prod.your-domain.com
# 测试环境配置
%test.mp.openapi.servers=https://test.your-domain.com
# 本地开发环境配置
%dev.mp.openapi.servers=http://localhost:8080

内容的提问来源于stack exchange，提问作者Maria Pedro Sales