
先保留原文,再比较编码结果
接口联调时,一段中文说明经过编码传递,接收方解出来却多了换行、少了 emoji,或者直接报错。此时只比较两串 Base64 是否长得一样,难以判断原文是否保留,也难以定位变化发生在哪一步。
AIGoCode 工具目录提供 Base64 文本编解码,在 UTF-8 文本与 Base64 之间转换,支持 URL-safe 和填充选项。下面围绕一段虚构文本,整理编码、传递、还原的人工验收记录。工具入口负责文本转换,接口是否接受某种写法,仍以接收端约定为准。
准备一个能暴露问题的小样本
建议先在本地编辑器保留原文副本,用两行文字,例如第一行“联调样本 A”,第二行“状态:待确认 😀”。在记录中明确第二行前有一次换行,末尾是否还有换行也要单独写清。不要使用真实客户资料、密码或 API Key。
这个样本同时包含中文、英文、空格、换行和 emoji,便于发现只用纯英文时不容易暴露的问题。它是用于人工测试的建议样本,不是本次已调用业务接口成功的证明。
编码前先问接收方三个问题
第一,字段收的是普通文本、编码后的文本,还是文件内容?确认字段文档后再操作。不能把图片或 PDF 的任意字节当成 UTF-8 文本交给文本工具,也不要给已经编码的值再编码一次,除非协议明确要求多层编码。
第二,字段要求标准 Base64,还是 URL-safe 写法?第三,末尾填充如何约定?将这两项写入交接记录。AIGoCode 目录确认工具提供相关选项,但选项可用不代表业务接口全部接受。
如果值还要经过 URL 查询参数、表单或 JSON,把外层传输方式也写清。编码文本与外层容器是两个步骤,容器的转义要求应按相应协议处理,避免将接收端看到的字符串与编辑器中的原值混为一谈。
做一次完整的往返对照
打开Base64 文本编解码,按已确认的约定选择方向和选项,将原文转成 Base64。先保留编码结果,再把它作为解码输入,拿还原文本与编辑器中的原文副本比较。
建议逐项核对中文、emoji、空格、行数与末尾换行。界面上“看起来一样”仍可能漏掉首尾空白;可以在本地编辑器开启空白字符显示,或借助文本对比检查。AIGoCode 的文本 / 代码 Diff 对比在目录中有明确入口,是否满足具体字符级检查需要以实际界面为准。
接着把编码结果走一次项目既有测试链路,记录发送前的值、接收后待解码的值和最终原文。全部使用虚构样本。在允许检查的测试环境逐段比较,哪一段第一次出现差异,就优先调查那一段的拼接、截断、转义或额外转换。
报错和乱码要分开记录
若解码报错,先保留原始输入与完整错误信息,检查复制是否完整、有没有混入引号或字段名,以及接收端要求的编码写法是否一致。不要直接删字符直到页面不再报错,否则可能把错误输入变成另一段可解码内容。
若能还原但文字不对,回到编码前的原文检查字符与换行。再确认来源是否确为文本、双方是否按同一字符编码处理。转换成功只说明当前步骤能处理这份输入,并不证明它等于最初要传递的业务内容。
一份可复核的交接记录
| 项目 | 建议保存的内容 |
|---|---|
| 原文样本 | 虚构文本副本、行数与末尾换行约定 |
| 编码约定 | UTF-8、标准或 URL-safe、填充要求 |
| 传递路径 | 字段名与外层容器,不含真实凭据 |
| 对照结果 | 本地往返是否一致,链路首次差异点 |
| 待确认项 | 接收端拒绝原因或尚未取得的接口约定 |
Base64 是可还原的编码,不能用来隐藏密钥或隐私。验收结果应写成“该样本在这些选项和这条测试路径下是否一致”,不要扩大成所有文本或整个接口都已验证。若任务实际是保存图片接口返回内容,应另走文件解码与格式检查流程,不套用这份文本验收记录。