假设一个图片增强页面接到了六张待处理的照片。界面上看，它们都是能打开的照片；提交到后续增强模块前，却必须回答两件事：第一张图在文件里按横向存储，为什么预览看起来竖着？第二张图分辨率很高，是否真的有必要完整解码后再缩小？这不是增强算法的锐化参数问题，而是输入契约不清楚。后端拿到的像素排列若与用户看到的方向不同，边缘判断和区域选择就可能落在错误的位置；提前分配大图内存，再事后缩小，则可能让一个本来容易完成的任务耗尽预算。

这篇以 PortraitInputGate 为演示工程，任务 ORI-1010-15。它不声称执行了华为图像超分模型，也不演示某个未核实的推理接口。重点是 Image Kit 已公开的 ImageSource、PixelMap 图像解码与变换能力，以及应用层对方向、像素数量和资源归属的控制。六张图片只是一组固定输入夹具：四张通过前置计划检查，两张进入人工复核。本文的界面图、HiLog 和测试数字均为模拟数据，不能当作真机运行证据。

一、先把“文件方向”和“眼睛看到的方向”分开

容易出现误差的环节通常不是旋转函数本身，而是在记录尺寸时不说清楚测量的是哪一张坐标纸。一张编码尺寸为 4032×3024 的 JPEG，夹具约定其方向标记为 EXIF 6，即按约定顺时针旋转 90 度后再展示。这样，原始排列是横向的，而目标展示画面是 3024×4032 的竖向。若应用先用横图宽度计算缩放，再拿竖图尺寸做验收，像素数量虽然不变，宽高边界会颠倒。

因此，我会给每个图像任务记三组数据：文件记录的宽高、方向纠正后的宽高，以及最终准备提交给下一阶段的宽高。它们的名字要能让阅读代码的人一眼看出先后关系。对于本篇这张 IMG-042.jpg，原图 4032×3024，旋转目标 90°，目标输入 1512×2016。输入预算为 4,000,000 像素，而目标图实际占 3,048,192 像素。仅从像素数看，它在预算内。这里没有把字节数、色深和纹理开销等同于像素数。

方向码也不能让一个任意整数悄悄混进工作流。演示夹具限定识别 1、3、6、8 四种常见方向语义，分别映射为 0、180、90、270 度。真实照片可能包含镜像类 EXIF 方向码，生产实现必须补充镜像处理或明确拒绝；本篇选择更保守的策略，不把未覆盖的方向码默认为零度。对方向缺失的情况可以按产品政策选择默认方向，但必须在报告里留下“推断”痕迹，不能冒充元数据已确认。

更重要的是，读取元数据的步骤与实际改变像素的步骤不等价。有的展示组件可能按元数据解释方向，也可能有自己的渲染逻辑；不能据此认定增强模块读到的像素已按同样规则摆正。本文刻意使用两个词：plannedRotation 表示应用计划执行的变换；pixelRotationVerified 则表示真实解码和变换完成后有证据可查。演示阶段只有前者，后者仍是 NOT_RUN。

1. 数据契约不是一张好看的统计卡

本例固定的数据契约如下：工程 PortraitInputGate，主页面 InputGatePage，诊断页面 OrientationAuditPage；任务 ORI-1010-15，当前图片 IMG-042.jpg；六张输入中四张 PLAN_READY、两张 REVIEW_HOLD，整批状态 PRECHECK_HOLD。其中 IMG-045.jpg 的夹具方向码为 0，不在支持集合；IMG-046.jpg 缺少可用尺寸，因此不能计算目标像素。两张都不进入解码环节。

时间戳统一采用演示的 10:45。这些字段会在代码、页面和诊断图中复用，减少“文章写通过四张，截图却显示五张”的手工错误。项目中的数据源属于预定义夹具，不是对用户真实相册的批量枚举；也没有假装获得某项系统授权。只有把这一点写明，读者才知道哪些行为已经由程序证明，哪些只是准备在 DevEco 工程里继续验证。

二、把方向与像素数先算成纯函数

不必一进入页面就创建 PixelMap。第一步完全可以只靠尺寸与元数据做一份可复算的计划。纯函数更容易测试：输入固定，输出固定；窗口切换、页面消失、异步回调也不会改变计划的计算方式。它同样便于教学，学生不需要设备就能先检查边界。

下面的 ArkTS 风格代码专门解决“旋转以后宽高是否互换、目标像素是否超预算”的问题。方向码来自演示输入，不等于 Image Kit 自动返回了这张夹具的 EXIF 值；真正从文件读取方向属性需要按照实际 ImageSource 版本接口另行接线。返回的 PLAN_READY 也只代表静态计算合格。

interface PhotoFixture {
  id: string;
  rawWidth: number;
  rawHeight: number;
  exifOrientation: number;
}
interface DecodePlan {
  id: string;
  rotateDeg: number;
  decodeWidth: number;
  decodeHeight: number;
  outputWidth: number;
  outputHeight: number;
  pixels: number;
  status: string;
}
const ORIENTATIONS: Record<number, number> = {
  1: 0, 3: 180, 6: 90, 8: 270
};
function makePlan(photo: PhotoFixture, budget = 4000000): DecodePlan | undefined {
  const deg = ORIENTATIONS[photo.exifOrientation];
  if (deg === undefined || photo.rawWidth <= 0 || photo.rawHeight <= 0) {
    return undefined;
  }
  // 演示约定按二分之一解码；目标是否符合业务画质要求须另行测量。
  const decodeWidth = Math.floor(photo.rawWidth / 2);
  const decodeHeight = Math.floor(photo.rawHeight / 2);
  const swap = deg === 90 || deg === 270;
  const outputWidth = swap ? decodeHeight : decodeWidth;
  const outputHeight = swap ? decodeWidth : decodeHeight;
  const pixels = outputWidth * outputHeight;
  return { id: photo.id, rotateDeg: deg, decodeWidth, decodeHeight,
    outputWidth, outputHeight, pixels,
    status: pixels <= budget ? 'PLAN_READY' : 'REVIEW_HOLD' };
}

对 IMG-042.jpg，先二分之一得到 2016×1512，再按方向规划交换为 1512×2016，相乘恰好 3,048,192。宽高虽然变化，乘积没有变化，这是很好的自检线索。若有人把目标填成 1512×4032，像素数会突然翻倍；即使UI看似能显示，计划数据也已经自相矛盾。

这里把二分之一写死，是为了让夹具向读者呈现清晰的计算链。生产系统应根据业务目标、硬件内存、压缩格式、色彩空间和图像内容决定合理目标；不要将“4MP预算”和“二分之一”理解为华为官方的强制数值。像素预算只拦截一种最粗的风险，不能替代真实内存峰值与解码耗时的统计。

在设计检查页面时，还应显示“方向来源”。它可能来自EXIF元数据，也可能来自用户手工修正，甚至来自没有方向标签时的保守默认值。这三种来源不能混写成同一个已确认字段。建议输出orientationSource=EXIF、MANUAL或UNKNOWN，错误记录保留原始标记和值域。如果未来加入手动旋转按钮，用户修正后的角度应独立于原始EXIF保存，并能撤销；不要覆盖原始文件以求方便。否则重新编辑或再次选择图片时，应用就难以解释图片为何转过一次又转了一次。

还有一个交付边界是缩略图。很多项目为了加速首屏，会把列表缩略图拿来计算原图方向，但缩略图可能已经被相册服务做过方向预处理，甚至经过中心裁剪。它能作为显示预览，却不应替代原始文件的尺寸与方向证据。若解码输入与缩略图不是同一份字节内容，最好分别保存图像ID、源文件哈希与预览变体标识。这样在增强效果出现旋转或边缘截断时，才能快速判断究竟是预处理计划错误，还是上游缩略图和原图被混为一谈。

另一个边界是 EXIF 5、7 类镜像方向。读者可能会问，既然画面仍可以旋转出来，为何直接挂起？因为镜像方向不是单靠 90 度旋转就能还原，简单“对号入座”会造成左右颠倒。对需要人脸或文字方位一致性的图像增强任务，这比明确暂不支持还危险。夹具将未知方向列为 REVIEW_HOLD，便于以后扩展明确的镜像矩阵。

三、真正解码时，只申请计划允许的尺寸

静态计划产生后，才进入 Image Kit 边界。华为 Image Kit 文档公开了通过 image.createImageSource 获取图像源、使用 getImageInfo 查看尺寸、调用 createPixelMap 创建像素图，以及释放相关对象的基本链路。Image Kit 也提供 PixelMap 图像变换能力。需要特别留意：新版SDK的接口参数以及不同设备的图像特性，应在目标DevEco环境确认，不能从一张IDE风格生成图推断代码已编译。

下面这段是单张输入的顺序化示例，演示“先计划，再解码，再确认变换结果”的资源所有权。示例假设调用方已经通过受控文件路径取得合法访问权，不代替Photo Picker的授权过程。ImageSource不允许被随意跨并发调用共享：提前释放或在异步操作仍运行时复用对象可能引发崩溃，这在官方Image Kit常见问题文档中也有明确说明。

import { image } from '@kit.ImageKit';

async function decodePlannedImage(path: string, plan: DecodePlan): Promise<image.PixelMap> {
  if (plan.status !== 'PLAN_READY') {
    throw new Error('Input is not authorized by the planning gate');
  }
  const source = image.createImageSource(path);
  let pixelMap: image.PixelMap | undefined;
  try {
    const info = await source.getImageInfo();
    if (info.size.width !== plan.decodeWidth * 2 ||
        info.size.height !== plan.decodeHeight * 2) {
      throw new Error('Source dimensions changed after planning');
    }
    pixelMap = await source.createPixelMap({
      desiredSize: { width: plan.decodeWidth, height: plan.decodeHeight }
    });
    if (plan.rotateDeg !== 0) {
      await pixelMap.rotate(plan.rotateDeg);
    }
    const actual = await pixelMap.getImageInfo();
    if (actual.size.width !== plan.outputWidth ||
        actual.size.height !== plan.outputHeight) {
      throw new Error('Decoded dimensions differ from the plan');
    }
    const result = pixelMap;
    pixelMap = undefined; // 将像素图所有权转移给调用方
    return result;
  } finally {
    if (pixelMap) { pixelMap.release(); }
    source.release();
  }
}

这段代码里的 source.release() 放在 finally，前提是所有由该 ImageSource 发起的异步操作都已通过 await 结束；不能复制为“任何时候都立即释放”。返回给调用方的 PixelMap 也不能立刻在本函数内释放，否则后续预览与增强模块读到的可能是失效资源。代码用“所有权转移”显式表达这一点，消费者最终必须在页面退出、替换图片或工作取消之后释放它。

还有一个需要现场核实的细节：ImageSource元数据尺寸、desiredSize实际输出尺寸、旋转操作的像素结果，不同格式和SDK行为可能带来偏差。上面的计划以固定夹具构造，工程真正接入时必须检查 getImageInfo 结果。如果解码器没有严格遵照目标尺寸，应该挂起并报告实际尺寸，绝不能因为代码里写着 desiredSize 就当作内存预算已被落实。

图片格式与色彩空间也会影响可用性。只有像素数满足预算，不能说明Alpha通道、HDR色彩或YUV格式必定能被目标增强模块接受。照片可能在预览看起来一样，实际像素格式却不同；这时应把“方向统一”“尺寸统一”“像素格式统一”拆开验收。文章的演示只验证前两项的计划层约束，第三项是待扩展工程任务。

四、把迟到结果与页面生命周期绑在一起

当用户从 IMG-042.jpg 切到下一张图时，上一张解码可能还在运行。不能因为下一张图片已经被选中，就假定上一张异步操作会自动取消。这里不虚构Image Kit有一个任意场景通用的“取消解码”接口，而是在应用层设置递增任务代次，异步返回后检查这次结果是否仍属于当前用户选择。过期结果要释放，不能放进当前预览，更不能交给增强阶段。

这个问题还容易和折叠屏页面重建混在一起。窗口变化只应该更新布局坐标，不必无缘无故重新解码同一张图；图片选择变化才需要替换任务。用户按下“返回”后，先标记当前任务失效，等未完成的异步结束时回收返回对象。不要在有未完成读写时把其依赖的资源直接强制释放，那会把“取消”写成潜在崩溃。

下面是演示级的结果所有权控制。它没有对Image Kit私有实现作任何假设；produce是可注入的已核查异步解码函数，便于在无设备的情况下用虚拟PixelMap对象测试迟到分支。

class PixelMapTicketGate {
  private currentTicket: number = 0;
  private disposed: boolean = false;
  staleReleased: number = 0;

  async run(produce: () => Promise<image.PixelMap>): Promise<image.PixelMap | undefined> {
    if (this.disposed) { return undefined; }
    const ticket = ++this.currentTicket;
    const map = await produce();
    if (this.disposed || ticket !== this.currentTicket) {
      map.release();
      this.staleReleased += 1;
      return undefined;
    }
    return map; // 有效对象由页面或后续处理器管理释放
  }
  invalidate(): void { this.currentTicket += 1; }
  dispose(): void {
    this.disposed = true;
    this.invalidate();
  }
}

这里的风险不在版本整数有多大，而在资源引用是否被两个模块同时认为自己拥有。若UI与增强任务同时引用PixelMap，其中一个页面退场时就把对象释放，另一个模块仍在使用会出现未定义行为。生产项目需要更完整的引用所有权协议或复制数据策略；本例只演示单消费者移交。重复调用dispose不会再次释放图片，但调用方持有的有效PixelMap依旧要自行完成释放。

演示页面InputGatePage把状态分为FIXTURE_LOADED、PLANNING、PRECHECK_HOLD，而不是简单写“处理成功”。两张待复核样本存在时，整批数据必须停在PRECHECK_HOLD。当前图片的规划可以显示PLAN_READY，这与整批阻断不矛盾：局部计划合格，并不等于全部照片合格，更不等于模型已经完成超分。

五、运行页应把“没有运行”也展示出来

本次生成的手机主界面显示六张输入示意卡片，IMG-042.jpg被选中。其记录为编码4032×3024、元数据方向6、旋转计划90度、二分之一解码2016×1512、归一化目标1512×2016、像素数3,048,192、预算4,000,000。页头能看到四张通过、两张挂起，以及整批PRECHECK_HOLD。右侧或下方的辅助标签不应该写“超分完成”，因为本例根本没有运行推理。

只有让“计划已就绪”和“真实图片已完成解码”在界面上有不同字段，读者才会在发现数值异常时知道要从哪里排查。对于教学场景，我会把 decodeAttempted=0、modelInference=NOT_RUN也放进诊断页。看起来它们没有“100%完成”的进度条那么醒目，但更接近真实工程报表需要的诚实程度。

演示日志统一以任务号 ORI-1010-15 开头。可以记录 plan IMG-042 rotate=90 out=1512x2016 pixels=3048192、checked=6 ready=4 hold=2、state=PRECHECK_HOLD decode=NOT_RUN。如果将来执行真实解码，应增加ImageSource创建、期望尺寸、实际尺寸、结束时间、PixelMap释放情况以及异常码的结构化字段，不要靠一整行自由文本猜测谁先谁后。

有一张照片虽然方向有效，但解码过程可能因为坏文件失败。在这种情况下，不应将它计入通过量，也不应让此前渲染成功的旧图冒充当前结果。用户看到的应该是具体的“解码失败、可重新选择”的状态。页面中的按钮“查看方向诊断”进入一个只展示模型数据的详情页，而不是假装把系统错误弹给了用户。

六、诊断页面比成功动画更值得花时间

在OrientationAuditPage里，最重要的不是再画一张大图，而是让每一种挂起原因可追踪。此例的两条记录分别为：IMG-045.jpg 使用未支持的方向码0；IMG-046.jpg没有合法像素宽高。它们虽然都被挂起，却不能合并成“图片错误2”。前者需要完善方向映射或请用户重新导入，后者需要检验文件数据与元数据读取失败的分支；处理手段不相同。

调试时应先读夹具，再读纯函数，再看资源层。若IMG-042.jpg计划数错了，查除二与宽高交换；若计划正确、实际PixelMap信息错了，查解码器输出与旋转次序；若画面偶尔显示上一张，查任务票据与资源释放；若两张待复核突然变成通过，查是否有人把失败条件改成宽松默认。这种层级有助于避免每次异常都去怀疑图像模型。

还需要安排至少四种反例：方向码不在支持集合、宽高为0、解码后的尺寸不匹配、页面离开后异步结果才返回。另加一个重复点击“开始检查”的用例，检查是否错误共享ImageSource；有些异步接口虽能同时返回，但不表示同一原生对象可以被安全并发使用。官方Image Kit的常见错误文档对共享ImageSource导致的问题有明确警示，工程上应把这个边界写进资源管理单测。

七、上线之前仍需要补的证据

今天能确定的只是静态计划：样本数学计算正确，四张计划通过，两张因为夹具缺陷挂起；没有真实设备的解码耗时、内存峰值、格式兼容性与推理结果。接下来真正接入工程时，我会先用相同图片集合生成可复核的测试清单，保存系统版本、DevEco SDK版本、设备型号和图片散列，再比对解码前后宽高与实际色彩结果。

如果后续接上图像超分，需要把“预处理输出可被接受”和“模型结果可用于交付”分成两张验收单。图像尺寸变小不代表模型内部缩放比固定，更不意味着质量损失可忽略。画面朝向修好之后，还要测试增强输出的边界、透明度、内存和异常恢复。这里只提出接口契约，不伪造某个未被官方资料证实的超分算法调用名称。

选择4MP预算也只是示意。手机设备能力、图片编码方法、相册文件可达性、对HDR的处理方式都会改变实际峰值。以RGBA每像素4字节作粗估，3,048,192像素约需12.2MB的原始像素空间，但中间解码缓存、临时变换缓冲和GPU纹理可能让峰值更高。把这个数字解释成总内存峰值将是错误的。性能验收应靠真实设备上的Profiler、HiLog与资源生命周期数据，而不是数学近似值。

最终这一篇希望留下的是一个简单但可靠的工程顺序：先验证方向语义与输出像素预算，再创建真实PixelMap；先证明图片属于当前请求，再允许结果进入后续模型。 它不像“增强前后效果图”那么抢眼，却能为后续的正确性和稳定性少埋很多雷。至于真实解码、超分推理及内存曲线，本次都明确记为NOT_RUN，等有设备和目标SDK以后再填证据。

官方参考与验证边界

• 华为Image Kit图像变换：使用PixelMap完成图像变换，文档更新于2026-09-09。
• 官方异常案例：Image Kit常见崩溃报错问题，包括异步解码时的资源释放与共享风险。
• Image Kit概览，用于区分ImageSource、PixelMap与设备限制。

**最后核对：**本篇IMG-042.jpg的数据是纸面夹具，PRECHECK_HOLD仅为应用自定义预检状态；请勿误读为华为系统或算法实际返回的状态码。