在curl 挨个试过都正常，上真机上，删一个会话，弹窗「服务返回 HTTP 501」。

DevEco Studio 26.0.0.851，SDK API 26，真机 SGT-AL10，HarmonyOS 7.0.0.109。服务端是我自己拿 Python 

 写的一个小桥，跑在 Windows 上，手机通过 Tailscale 连过来，纯 HTTP 加一个自定义 token。会话列表、流式输出、文件上下行全走这套接口。

三个坑按撞上的顺序写。每个坑我一开始都怀疑服务端，三次都猜错。

删完会话要刷新列表，501 就是这时候弹的。我去翻桥的日志，同一时刻那条删除请求成功到达，也处理完了。

不对劲的地方在响应体。原文写着 

 对不认识的 method 的默认回包，可我的服务明明写了 

我先怀疑自己看错了日志。给桥加上逐请求日志，一行一条，格式是 

，然后在手机上又复现了一遍。

日志里没有那条 GET。一条都没有。

请求没到服务端，客户端却收到了一条 501 响应。中间还能有谁。

 字段，注释原文是 If this item is not configured, the system proxy is used by default。不显式配，请求会走系统代理。

当时手机挂着 VPN，它那个本地代理只处理 CONNECT 隧道，明文的 HTTP GET 进去，被它当成了认不出的方法，回了一个 501。至于这个代理为什么用 Python 的报错格式回包，我没去查，跟问题本身没关系。

 就一路盯着自己的服务端看，从头到尾没想过客户端和服务端之间还夹着一层。

const req = http.createHttp();
const resp = await req.request(Api.url(path), {
  method: http.RequestMethod.POST,
  header: Api.header(),
  extraData: body.length > 0 ? body : undefined,
  connectTimeout: connectMs,
  readTimeout: readMs,
  // 不走系统代理。手机挂着 VPN 或代理时，明文请求可能被它吃成
  // 501 Unsupported method，而服务端根本收不到包
  usingProxy: false
});

改完之后，后面几轮真机上这一条没再出现过。要说彻底根除，我手上只有这几轮的观察，没做过开关代理的对照实验，不敢讲满。

这个坑还带出一个小的。我拿 HEAD 请求探活，桥当时只实现了 

，探活自己也吃到 501。补一个返回 204 的空 

 就干净了。这件事教训是探测姿势得对，拿错误的探测结果当证据，只会把方向带得更偏。

DELETE 带上请求体，请求根本没发出门

。我用 curl 手发一毛一样的 DELETE 请求，服务端 200 正常返回。

这次判据来得快。桥的逐请求日志里，一条 DELETE 都没有，请求没出门。而 401 那个错误码也不是服务端给的，是鸿蒙 http 栈在客户端本地造出来的。

 这个组合，直接抛 401，不发包。换方法就行，语义塞进路径。

// 不可用。鸿蒙 http 栈对 DELETE + extraData 直接抛 401，请求不会发出
// method: http.RequestMethod.DELETE, extraData: JSON.stringify({...})

const req = http.createHttp();
const resp = await req.request(Api.url('/api/sessions/' + sid + '/delete'), {
  method: http.RequestMethod.POST,
  header: Api.header(),
  usingProxy: false
});

这里有一条是我拿代价换的。探删除接口的鉴权行为时，我为了省事，直接拿了一条真实会话的 sid 去试，结果真把它删了，后来靠补上的 

 才捞回来。探鉴权用不存在的假 sid 就够了，本来要验的只有能不能进门，把真数据搭进去没有任何好处。

会话的「重命名」和「连接设置」都是半模态。两个 sheet 都挂在页面根节点上，点菜单项，状态变量确实变成 

先怀疑菜单的点击没触发，加日志打了一圈。点击进去了，状态也改了，界面没动。那问题就在组件层。

，会互相吞，后绑的接管，先绑的静默失效。官方文档写了这件事，只是埋在一份很长的组件文档里，代码层面完全看不出来。编译通过，状态正常，没有异常，日志不报错。

这坑还有另一种长相。我先给模型胶囊按钮绑了一个，又给页面根节点绑了一个，结果是弹出两个 sheet 叠在一起，看着像层级乱了。

@State showSheet: boolean = false;
@State sheetMode: string = ''; // 'rename' | 'conn'

// 触发处只置模式，不各自弹 sheet
this.sheetMode = 'rename';
this.showSheet = true;

// 页面根节点，全页唯一一处 bindSheet
.bindSheet($$this.showSheet, this.mainSheet(), {
  height: this.sheetMode === 'rename' ? 260 : 380,
  dragBar: true,
  backgroundColor: $r('app.color.sheet_bg'),
  blurStyle: BlurStyle.COMPONENT_ULTRA_THICK
})

 分支渲染两套内容，高度也跟着走。改完两个入口都正常，观感还统一了。

这条后来成了我自己的一条规矩。一个宿主节点只绑一个 

，要几套半模态就用单状态机切，别开多个绑定。

每处修复都在五行以内。时间基本都花在找方向上，写代码只占最后几分钟。三次我都先怀疑服务端，三次日志都告诉我请求没出门。同一个动作重复三遍，我才算把「先看服务端到底收没收到包」变成条件反射。

现在这套代码里，所有请求参数统一带 

，删除一律走 POST，全页只有一处 

。这几条谈不上什么设计，都是被真机打过之后才加上的。

如果你正在写直连自有服务的鸿蒙应用，这三个参数值得先记下。

，DELETE 别带 body，一个宿主只绑一个 

。全都是三十秒能改完的事，找它们每一条都可能花掉半天。

鸿蒙 ArkTS 真机排查实录，三个「代码没错」却跑不通的坑

一个直连自有 HTTP 服务的鸿蒙 App，在 curl 里全部正常，装到真机却连撞三个坑。http 请求莫名返回 501，DELETE 在本地抛 401，bindSheet 点了没反应。三个坑代码层面都看不出问题。本文记录每个坑的定位路径、根因与可复用修复代码。

软件测试工程师

编程语言

鸿蒙真机HTTP请求三个隐藏坑：VPN代理吞明文请求致501、DELETE带extraData被本地栈拒绝报401、同节点多bindSheet静默失效。解决方案：显式设置usingProxy:false、改用POST传递语义、单状态机切换半模态。附真实排查日志，每个坑都曾误判服务端，实为客户端行为。

Windows

路由

Python

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

鸿蒙 ArkTS 真机排查实录，三个「代码没错」却跑不通的坑

鸿蒙 ArkTS 真机排查实录，三个「代码没错」却跑不通的坑

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐