鸿蒙报错速查：arkts-strict-typing Property does not exist on type 'object'，object 装函数就炸，根因 + 真解法

报错原文

ERROR: 10505001 ArkTS Compiler Error
Error Message: Property 'fn' does not exist on type 'object'. At File: xxx.ets:N:N

常伴生报错：

Error Message: Object literal must correspond to some explicitly declared class or interface (arkts-no-untyped-obj-literals)

报错触发场景

你写鸿蒙 ArkTS 时，用 object 类型装函数成员就炸：

// ❌ 报错写法
@State obj: object = { fn: (x: number): number => x * 2 }
const calc: object = { double: (x: number): number => x * 2 }
const result = obj.fn(42)  ← Property 'fn' does not exist on type 'object'

根因

鸿蒙 ArkTS 的 object 是基类类型 ------只含 toString/hasOwnProperty 等基类方法，不含任何业务属性 。编译器拒绝在 object 上访问未定义的属性（fn/double 等）。

这跟前端 TS 最大的差异：TS 里 object 装任意对象字面量能动态加属性访问，ArkTS 里 object 严守基类契约，加属性就报错。

ArkTS 这么设计的原因：编译期消除一切歧义 ------object 装函数成员是「动态形状」，编译器分析不了；要求显式 interface / 函数类型 / type 别名定义形状，编译期就能检查类型安全。

真解法

三种替代方案，按场景选：

解法 1：interface 显式定义函数成员（最常用）

// ✅ 正解 1：interface 显式定义函数成员替代 object
interface Calculator {
  fn: (x: number) => number
}

const calc: Calculator = { fn: (x: number): number => x * 2 } as Calculator
const result = calc.fn(42)  ← 编译过，Calculator 有 fn 属性

interface 显式定义对象形状------编译器知道 Calculator 有 fn 属性，访问不报错。

解法 2：直接标函数类型

// ✅ 正解 2：直接标函数类型替代 object
const double: (x: number) => number = (x: number): number => x * 3
const result = double(42)  ← 编译过，double 是函数类型可调

直接标 (x: number) => number 函数类型------不用包对象，直接变量装函数。

解法 3：type 别名标函数类型

// ✅ 正解 3：type 别名标函数类型替代 object（type 必须顶层定义）
type Predicate = (x: number) => boolean

const isBig: Predicate = (x: number): boolean => x > 10
const result = isBig(42)  ← 编译过，Predicate 是函数类型可调

type 别名给函数类型起名------复用方便。注意 type 必须顶层定义，不能嵌套在 struct 里。

高频踩坑场景

场景 1：@State obj: object 装回调

// ❌ 报错
@State handler: object = { onClick: () => { ... } }

// ✅ 正解（interface 定义）
interface Handler {
  onClick: () => void
}
@State handler: Handler = { onClick: () => { ... } } as Handler

场景 2：object 装策略对象

// ❌ 报错
const strategies: object = {
  add: (a: number, b: number): number => a + b,
  sub: (a: number, b: number): number => a - b
}
const result = strategies.add(1, 2)

// ✅ 正解（interface 定义）
interface Strategies {
  add: (a: number, b: number) => number
  sub: (a: number, b: number) => number
}
const strategies: Strategies = {
  add: (a: number, b: number): number => a + b,
  sub: (a: number, b: number): number => a - b
} as Strategies
const result = strategies.add(1, 2)

场景 3：API 回传 object 你接

// ❌ 报错（接 API 回传 object，访问属性炸）
const res: object = await someApi()
const name = res.data.name  ← Property 'data' does not exist on type 'object'

// ✅ 正解（显式 interface 接）
interface ApiResponse {
  data: { name: string }
}
const res: ApiResponse = await someApi() as ApiResponse
const name = res.data.name

场景 4：type 嵌套在 struct 里

// ❌ 报错（type 不能嵌套在 struct 里）
@Component
struct Index {
  type Predicate = (x: number) => boolean  ← 报错
}

// ✅ 正解（type 顶层定义）
type Predicate = (x: number) => boolean

@Component
struct Index {
  pred: Predicate = (x: number): boolean => x > 10
}

一句话速查

Property does not exist on type 'object' → object 不能装业务属性，用 interface / 函数类型 / type 别名替代

跟前端 TS 的差异

写法	TS	ArkTS
const x: object = { fn: () => 1 }	✅	❌ 报错
const x: { fn: () => number } = { fn: () => 1 }	✅	✅
const x: interface = { fn: () => 1 } as interface	✅	✅
const fn: () => number = () => 1	✅	✅

前端转鸿蒙最容易踩这个坑------TS 里 object 装任意对象字面量能动态加属性访问，ArkTS 里 object 严守基类契约。新项目从一开始就养成「禁用 object 装业务属性，显式 interface / 函数类型」的习惯，避坑。

object 三种替代速查表

替代方案	适用场景	写法示例
interface	对象含函数成员	interface C { fn: (x: number) => number }
直接函数类型	单函数变量	const fn: (x: number) => number = ...
type 别名	函数类型复用	type Pred = (x: number) => boolean（顶层定义）

铁律 ：ArkTS 里 object 只当基类用------装业务属性就 interface / 函数类型 / type，别想裸 object。

完整代码仓库

本文所有正解写法都已托管到 AtomGit：

🔗 仓库地址 ：atomgit.com/JaneConan/a...

仓库包含：

• 四种高频踩坑场景的 ❌ 报错写法 + ✅ 正解写法对照
• interface / 直接函数类型 / type 别名三种替代方案示范
• 可直接用 DevEco Studio 打开参考

---

作者：JaneConan 仓库：atomgit.com/JaneConan/a... 协议：Apache-2.0，随便用，别告我