Dart拼接含&的字符串异常：仅保留&前内容，求解决

架构老林

2026-8-3

问题分析与解决方案

核心原因

你看到的截断并非代码拼接失败，而是展示环境（如Web视图、FlutterFlow预览面板）将&解析为HTML实体的起始标记，导致&后的内容被当作未闭合的实体而隐藏。实际上代码拼接出的字符串本身是完整的，你可以通过print()或debugPrint()输出到控制台验证——控制台不会解析HTML实体，能看到完整结果。

解决方案：用`Uri`类规范构建URL

手动拼接URL容易出现这类解析问题，还可能忽略参数的URL编码（比如参数含特殊字符时出错），推荐用Dart内置的Uri类构建：

示例1：基础拼接场景

var someVariable = 'Hello';
var someOtherVariable = 'World';
var uri = Uri(
  host: 'somedomain',
  queryParameters: {
    'x': someVariable,
    'y': someOtherVariable,
  },
);
var str = uri.toString();
// 控制台输出完整结果：somedomain?x=Hello&y=World

示例2：FlutterFlow中的实际代码修改

Future<String> getEventUrlFromReference(BuildContext context, DocumentReference? eventReference) async {
  var userId = currentUser?.uid as String;
  var uri = Uri(
    scheme: 'https',
    host: 'somedomain.com',
    path: '/event',
    queryParameters: {
      'eventReference': eventReference?.id,
      'invitedBy': userId,
    },
  );
  return uri.toString();
}