我认为使用 Map 作为api的一个参数是不好的做法，因为很难理解api真正需要什么。在一些古老的法典中，我发现了这样的方法：

doSomeStuff(Session session){
  String aa = session.get("aa");
  String bb = session.get("bb");
  return aa + bb;
}

此代码的重构将是：

doSomeStuff(String aa, String bb){
  return aa + bb;
}

你知道你需要 aa 以及 bb 调用api。

你总是追求“简约”的API。
在这种情况下：当您的api在传递一个Map时工作时，那么您当然选择了该路径。为什么要让你的客户先把Map包起来？！
方案1的优点是——这是一条直截了当的道路。
而选项2的缺点是使用api更加困难。
换句话说：如果该参数的中心“属性”是“to be a map”，那么它应该作为map传递。但是，当“中心主题”是不同的东西时，你就传递了一些与另一个主题相关的东西。