Flutter Retrofit中使用@Url实现动态端点失效问题排查

Dart版Retrofit（retrofit.dart）支持动态指定完整API端点，但用法和Kotlin版Retrofit存在差异，你遇到的两个错误可以通过以下方式解决：

错误原因与解决步骤 #

1. "@POST注解提示缺少参数" #

Dart版的@POST注解必须传入路径参数，不能为空。Kotlin版允许@POST不带参数配合@Url使用，但Dart版不支持这种写法，必须给@POST提供一个占位路径。

2. "@Url注解未定义" #

Dart版Retrofit没有@Url注解，Kotlin中用@Url实现的动态URL功能，在Dart里需要通过@Path注解配合占位路径来实现。

正确实现代码示例 #

1. 接口定义 #

确保导入retrofit包，然后按以下方式定义接口：

import 'package:dio/dio.dart';
import 'package:retrofit/retrofit.dart';

@RestApi(baseUrl: "https://placeholder-base-url.com/") // 占位baseUrl，实际会被完整URL覆盖
abstract class TicketApi {
  factory TicketApi(Dio dio) = _TicketApi;

  // 使用{endpoint}作为占位符，配合@Path传入完整URL
  @POST("{endpoint}")
  Future<Response> purchaseTicket(
    @Path("endpoint") String fullEndpoint,
    @Body() RequestModel request,
  );
}

2. 调用示例 #

当传入的fullEndpoint是完整URL时，Retrofit会自动忽略配置的baseUrl，直接使用这个完整地址：

// 初始化Dio和Api实例
final dio = Dio();
final ticketApi = TicketApi(dio);

// 传入完整API端点调用接口
await ticketApi.purchaseTicket(
  "https://your-actual-api.com/tickets/purchase",
  RequestModel(/* 你的请求参数 */),
);

补充说明 #

• 如果不想设置占位baseUrl，可以将其设为"https://"，但建议保留一个合法的占位地址，避免Dio的URL解析报错。
• 若只是动态拼接baseUrl后的路径，直接用@Path替换路径中的变量即可，无需传入完整URL。

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