移动端断点续传时如何避免文件损坏？检查 ETag 与 If-Range
移动端下载中断后恢复时，若服务器未正确返回 ETag，可能导致文件内容错位或损坏。
理解 ETag 与 If-Range 的作用机制
HTTP 条件请求通过比较资源版本控制结果，其中 ETag 是唯一标识每个版本的不可见字符串。当客户端发起断点续传请求时，需要携带 If-Range 头部，该头部通常包含资源的 ETag 值。服务器收到请求后，会比对本地缓存的 ETag 与 If-Range 中的值。如果两者一致，服务器将返回 206 Partial Content 状态码，仅传输缺失的字节范围。如果 ETag 不匹配，服务器会忽略 Range 头部，转而返回 200 OK 状态码，发送完整的资源文件。这种机制确保了在下载过程中资源未被修改的情况下，客户端能准确接续下载。
ETag 的生成通常基于资源的哈希值，如 MD5 哈希或其衍生值。这意味着只要资源内容发生任何变化，包括内容编码的改变，ETag 都会随之更新。例如，当服务器对响应进行压缩时，某些配置会修改 ETag，如 Apache 服务器默认会在 ETag 中附加压缩方法名称。这种变化会导致客户端缓存的 ETag 失效，从而在续传时触发完整的资源重新下载。因此，确保 ETag 在内容编码变化时保持一致性，是避免文件损坏的关键步骤。
排查 ETag 不匹配导致的文件损坏问题
在移动端断点续传场景中，文件损坏通常源于服务器未正确处理 If-Range 头部。排查时，首先检查服务器是否正确发送了 ETag。可以通过开发者工具的 Network 面板查看响应头，确认是否存在 ETag 字段。如果 ETag 缺失或格式不正确，服务器可能无法正确验证资源版本。其次，检查 If-Range 头部是否正确携带了缓存的 ETag 值。客户端在发起续传请求时，必须从之前的响应中提取 ETag 并放入 If-Range 头部。如果 If-Range 为空或值错误，服务器将无法识别请求的上下文。
另一个常见问题是服务器在压缩响应时修改了 ETag。如果服务器配置了动态修改 ETag 的行为，例如在 ETag 中附加压缩标识，客户端缓存的 ETag 将与服务器当前返回的 ETag 不一致。这会导致续传请求失败，服务器返回完整资源而非部分内容。解决方法是检查服务器的 ETag 配置，确保在内容编码变化时 ETag 保持稳定。例如，禁用 Apache 的 DeflateAlterETag 指令，或使用静态 ETag 生成策略。
验证 ETag 与 If-Range 配置的正确性
验证步骤包括模拟断点续传请求并观察服务器响应。首先，发起一个完整的下载请求，记录响应头中的 ETag 值。然后，模拟下载中断，仅发送 Range 头部，并在 If-Range 中填入之前记录的 ETag。观察服务器返回的状态码和响应头。如果返回 206，说明 ETag 验证成功，续传正常。如果返回 200，说明 ETag 不匹配，服务器认为资源已更新。此时，检查服务器日志或响应头，确认 ETag 是否因内容编码变化而改变。
还可以通过对比 Last-Modified 日期与 ETag 来辅助验证。Last-Modified 是资源的最后修改日期，而 ETag 是唯一标识符。如果 Last-Modified 未变化但 ETag 发生变化，可能是服务器在内容编码或内容生成过程中引入了变化。这种情况下，客户端应重新下载完整资源，而非依赖续传。通过以上步骤，可以确认 ETag 与 If-Range 的配置是否符合预期，从而避免文件损坏问题。
优化 ETag 生成策略以提升续传稳定性
为了提升移动端断点续传的稳定性，建议优化 ETag 的生成策略。首先，确保 ETag 基于资源的原始内容生成，而非压缩后的内容。这意味着在生成 ETag 时，应忽略内容编码的变化。例如，使用资源的原始字节流计算哈希值，而非压缩后的字节流。其次，避免在 ETag 中附加动态信息，如压缩方法名称或服务器标识。静态 ETag 更能反映资源的实际内容变化，减少因编码或配置导致的误判。
此外，客户端在处理 ETag 时也应遵循最佳实践。在发起续传请求前，应检查缓存的 ETag 是否与服务器当前返回的 ETag 一致。如果发现不一致，应主动放弃续传，重新下载完整资源。这种策略虽然会增加一次请求，但能确保数据的完整性。通过服务器端和客户端的共同优化，可以显著提升移动端断点续传的可靠性和用户体验。
资料与延伸阅读
你可以通过以下原始资料核对文中概念，并继续深入阅读。