``` - 正确示例： ```html ``` 2. scroll-view 高度约束 - scroll-view 必须有明确的高度约束才能正常滚动 - 父容器需要设置 `flex: 1` 和 `height: 0px`（或 `height: 0`） - scroll-view 本身设置 `flex: 1` 和 `height: 100%` - 正确示例： ```css .parent-container { flex: 1; height: 0px; /* 关键：配合 flex: 1 使用 */ display: flex; flex-direction: row; } .scroll-content { flex: 1; height: 100%; /* 继承父容器高度 */ } ``` 3. 常见问题 - 问题：scroll-view 内容无法滚动 - 原因：缺少高度约束或 `height: 0px` 未设置 - 解决：确保父容器有 `height: 0px`，scroll-view 有 `height: 100%` ================================================================================ 六十七、switchTab 页面间参数传递（重要） ================================================================================ 1. switchTab 不支持 URL 参数 - `uni.switchTab` 不能像 `uni.navigateTo` 那样传递 URL 参数 - 错误示例： ```typescript uni.switchTab({ url: '/pages/category?categoryId=123' // 参数会被忽略 }) ``` 2. 使用 Storage 传递参数 - 正确示例： ```typescript // 发送页面 uni.setStorageSync('selectedCategory', categoryId) uni.switchTab({ url: '/pages/category' }) // 接收页面 onShow(() => { const savedCategoryId = uni.getStorageSync('selectedCategory') if (savedCategoryId != null && savedCategoryId != '') { uni.removeStorageSync('selectedCategory') // 清除，避免重复使用 // 处理参数 } }) ``` 3. 时序问题处理 - 问题：onShow 可能在数据加载完成前执行 - 解决：使用 pending 变量暂存参数，等待数据加载完成后处理 - 正确示例： ```typescript const pendingCategoryId = ref('') onShow(() => { const savedCategoryId = uni.getStorageSync('selectedCategory') if (savedCategoryId != null && savedCategoryId != '') { uni.removeStorageSync('selectedCategory') if (primaryCategories.value.length > 0) { // 数据已加载，直接处理 selectPrimaryCategory(savedCategoryId as string) } else { // 数据未加载，暂存等待 pendingCategoryId.value = savedCategoryId as string } } }) async function loadCategories(): Promise { // ... 加载数据 ... // 检查是否有待处理的参数 if (pendingCategoryId.value != '') { const id = pendingCategoryId.value pendingCategoryId.value = '' selectPrimaryCategory(id) } } ``` ================================================================================ 六十八、函数定义顺序严格检查（重要） ================================================================================ 1. UTS 中函数必须先定义后使用 - UTS 不支持 JavaScript 的函数提升 - 被调用的函数必须在调用之前定义 - 错误示例： ```typescript // 错误：selectPrimaryCategory 未定义 async function loadCategories(): Promise { // ... selectPrimaryCategory(categoryId) // 编译错误 } async function selectPrimaryCategory(id: string): Promise { // ... } ``` - 正确示例： ```typescript // 正确：先定义被调用的函数 async function selectPrimaryCategory(id: string): Promise { // ... } async function loadCategories(): Promise { // ... selectPrimaryCategory(categoryId) // 正确 } ``` 2. 变量使用前必须定义 - 错误示例： ```typescript if (systemInfo.windowWidth > 1025) { // 错误：systemInfo 未定义 // ... } const systemInfo = uni.getSystemInfoSync() ``` - 正确示例： ```typescript const systemInfo = uni.getSystemInfoSync() // 先定义 if (systemInfo.windowWidth > 1025) { // 正确 // ... } ``` 3. 推荐的代码组织顺序 ```typescript ``` ================================================================================ 六十九、CSS 渐变背景兼容性（重要） ================================================================================ 1. linear-gradient 在 uvue 中可能不支持 - 问题：`background: linear-gradient(...)` 在 Android 端可能不显示 - 解决：使用纯色背景 `background-color` 替代 - 错误示例： ```css .navbar { background: linear-gradient(135deg, #4CAF50 0%, #2E7D32 100%); } ``` - 正确示例： ```css .navbar { background-color: #4CAF50; } ``` ================================================================================ 七十、避免重复定义生命周期钩子（重要） ================================================================================ 1. 不要重复定义相同的生命周期钩子 - UTS 中如果定义了两个 `onShow`，它们都会被执行 - 这会导致逻辑冲突和意外行为 - 错误示例： ```typescript onShow(() => { // 第一个 onShow selectPrimaryCategory(id1) }) onShow(() => { // 第二个 onShow 也会执行 // 可能覆盖第一个的处理结果 }) ``` - 正确示例： ```typescript onShow(() => { // 合并所有逻辑到一个 onShow 中 // 处理 Storage 参数 // 处理页面参数 // 其他逻辑 }) ``` ================================================================================ 七十一、二级分类ID与一级分类ID的处理（重要） ================================================================================ 1. 分类页可能收到二级分类ID - 首页点击二级分类（如"男装"）跳转到分类页 - 分类页左侧栏显示的是一级分类（如"服装鞋帽"） - 需要将二级分类ID转换为其父级分类ID 2. 处理方案 ```typescript async function selectPrimaryCategory(categoryId: string): Promise { // 检查传入的是否是一级分类ID let targetCategoryId = categoryId const foundInPrimary = primaryCategories.value.find(c => c.id === categoryId) if (foundInPrimary == null) { // 传入的可能是二级分类ID，查找父级分类 const categoryInfo = await supabaseService.getCategoryById(categoryId) if (categoryInfo != null && categoryInfo.parent_id != null) { targetCategoryId = categoryInfo.parent_id } } activePrimary.value = targetCategoryId // ... 后续处理 } ``` 3. 最佳实践 - 在服务层添加 `getCategoryById` 方法获取单个分类信息 - 通过 `parent_id` 字段确定父级分类 - 如果找不到父级，回退到默认分类 ================================================================================ 七十二、Supabase .single() 方法兼容性（重要） ================================================================================ 1. `.single()` 在 UTS 中可能返回不同格式 - 问题：`.single()` 返回的数据可能导致类型转换异常 - 错误信息：`UTSArray cannot be cast to UTSJSONObject` - 错误示例： ```typescript const response = await supa .from('table') .select('*') .eq('id', id) .single() .execute() const rawData = response.data const obj = JSON.parse(JSON.stringify(rawData)) as UTSJSONObject // 可能报错 ``` 2. 解决方案：使用 `.limit(1)` 替代 ```typescript const response = await supa .from('table') .select('*') .eq('id', id) .limit(1) // 使用 limit(1) 替代 single() .execute() const rawData = response.data if (rawData == null) { return null } // 作为数组处理 const rawList = rawData as any[] if (rawList.length == 0) { return null } const item = rawList[0] const obj = JSON.parse(JSON.stringify(item)) as UTSJSONObject ``` 3. 最佳实践 - 避免使用 `.single()`，改用 `.limit(1)` - 始终将返回数据作为数组处理 - 检查数组长度后再取第一个元素 ================================================================================ 七十三、字符串比较必须使用 == 而不是 ===（重要） ================================================================================ 1. UTS Android 中 `===` 比较字符串可能失败 - 问题：即使两个字符串内容相同，`===` 也可能返回 `false` - 这会影响 `find`、`findIndex`、`filter` 等数组方法 - 错误示例： ```typescript const found = array.find((item) => item.id === targetId) // 可能失败 const index = array.findIndex((item) => item.id === targetId) // 可能失败 if (str1 === str2) { ... } // 可能失败 ``` 2. 解决方案：使用 `==` 或 for 循环 ```typescript // 方案1：使用 == 替代 === const found = array.find((item) => item.id == targetId) if (str1 == str2) { ... } // 方案2：使用 for 循环（推荐，更可靠） let foundItem: Item | null = null for (let i = 0; i < array.length; i++) { if (array[i].id == targetId) { foundItem = array[i] break } } ``` 3. 受影响的场景 - 数组查找：`find`、`findIndex`、`filter`、`some`、`every` - 字符串比较：`if (a === b)` - 对象属性比较：`if (obj.id === targetId)` 4. 最佳实践 - 在 UTS Android 中，**始终使用 `==` 而不是 `===`** 进行字符串比较 - 对于关键逻辑，使用 `for` 循环替代数组方法 - 添加调试日志确认比较结果 ================================================================================ 七十四、Supabase 查询应在数据库层面过滤（重要） ================================================================================ 1. 问题：先获取数据再手动过滤导致数据不足 - 错误示例： ```typescript // 错误：先获取 limit 条数据，再手动过滤 const response = await supa .from('ml_products') .select('*') .limit(20) .execute() // 手动过滤 category_id for (let i = 0; i < rawList.length; i++) { if (itemCatId == categoryId) { products.push(item) } } // 结果：可能返回 0 个商品，因为匹配的商品不在前 20 条中 ``` 2. 解决方案：在数据库层面进行过滤 ```typescript // 正确：在数据库层面过滤 const response = await supa .from('ml_products') .select('*') .eq('category_id', categoryId) // 数据库层面过滤 .eq('status', '1') // 使用字符串 '1' .limit(20) .execute() ``` 3. 需要手动过滤的场景 - 某些字段（如 `is_hot`、`is_new`、`is_featured`）可能无法在数据库层面过滤 - 解决方案：获取更多数据（limit * 5），然后手动过滤 ```typescript const response = await supa .from('ml_products') .select('*') .eq('status', '1') .limit(limit * 5) // 获取更多数据 .execute() // 手动过滤 is_hot for (let i = 0; i < rawList.length; i++) { if (isHotBool) { products.push(item) if (products.length >= limit) break } } ``` 4. 最佳实践 - 优先在数据库层面使用 `.eq()`、`.in()` 等方法过滤 - 整数字段使用字符串：`.eq('status', '1')` 而不是 `.eq('status', 1)` - 无法在数据库层面过滤时，获取更多数据再手动过滤 ================================================================================ 七十五、URL 参数类型转换（重要） ================================================================================ 1. 问题：URL 参数可能是不同类型 - 从 URL 传递的参数可能是 `string`、`number` 或其他类型 - 错误示例： ```typescript const priceOpt = opts['price'] as string // 错误：可能是 number this.product.price = parseFloat(priceOpt) // 运行时错误：java.lang.Double cannot be cast to java.lang.String ``` 2. 解决方案：检查类型后再转换 ```typescript const priceOpt = opts['price'] if (typeof priceOpt == 'number') { this.product.price = priceOpt as number } else if (typeof priceOpt == 'string') { this.product.price = parseFloat(priceOpt as string) } else { this.product.price = 0 } ``` 3. 通用类型安全获取函数 ```typescript function getNumberParam(opts: UTSJSONObject, key: string): number { const val = opts.get(key) if (typeof val == 'number') return val as number if (typeof val == 'string') return parseFloat(val as string) return 0 } function getStringParam(opts: UTSJSONObject, key: string): string { const val = opts.get(key) if (typeof val == 'string') return val as string if (typeof val == 'number') return (val as number).toString() return '' } ``` ================================================================================ 七十六、避免使用 .single() 和 .executeAs()（重要） ================================================================================ 1. 问题：`.single()` 和 `.executeAs()` 在 UTS Android 中可能失败 - 错误示例： ```typescript const response = await supa .from('ml_products') .select('*') .eq('id', productId) .single() .executeAs() // 可能报错：UTSArray cannot be cast to UTSJSONObject ``` 2. 解决方案：使用 `.limit(1)` 和手动解析 ```typescript const response = await supa .from('ml_products') .select('*') .eq('id', productId) .limit(1) // 使用 limit(1) 替代 single() .execute() const rawData = response.data if (rawData == null) return null const rawList = rawData as any[] if (rawList.length == 0) return null const item = rawList[0] const product = parseProductFromRaw(item) // 使用解析函数 return product ``` 3. 最佳实践 - 使用 `.limit(1)` 替代 `.single()` - 使用 `.execute()` 替代 `.executeAs()` - 使用统一的解析函数（如 `parseProductFromRaw`）处理数据 ================================================================================ 七十七、排序切换状态管理（重要） ================================================================================ 1. 问题：点击同一排序按钮时无法切换排序方向 - 需求：二次点击"价格"时，切换升序/降序 2. 解决方案：使用状态变量记录排序方向 ```typescript const priceAscending = ref(true) // 价格排序方向 const switchSort = (sortId: string) => { // 如果点击的是价格排序，切换升序/降序 if (sortId === 'price' && activeSort.value === 'price') { priceAscending.value = !priceAscending.value } else { // 切换到其他排序时，重置价格排序为升序 if (sortId !== 'price') { priceAscending.value = true } activeSort.value = sortId } // 重新加载数据 loadData() } ``` 3. 在数据加载时使用排序方向 ```typescript switch (activeSort.value) { case 'price': products = await supabaseService.getProductsByPrice(limit, priceAscending.value) break // ... } ``` ================================================================================ 七十八、加载更多逻辑（重要） ================================================================================ 1. 问题：加载更多时数据被替换而不是追加 - 错误示例： ```typescript const loadMore = async () => { const nextLimit = currentCount + 6 await loadHotProducts(nextLimit) // 这个函数会替换数据 } ``` 2. 解决方案：根据当前排序方式调用对应函数 ```typescript const loadMore = async () => { const currentCount = hotProducts.value.length const additionalLimit = 6 let newProducts: Product[] = [] switch (activeSort.value) { case 'sales': newProducts = await supabaseService.getProductsBySales(currentCount + additionalLimit) break case 'price': newProducts = await supabaseService.getProductsByPrice(currentCount + additionalLimit, priceAscending.value) break // ... 其他排序方式 } // 检查是否还有更多数据 if (newProducts.length <= currentCount) { hasMore.value = false } else { hotProducts.value = newProducts } } ``` 3. 最佳实践 - 每个排序方式对应独立的数据获取函数 - 传递 `currentCount + additionalLimit` 作为新的 limit - 比较返回数量判断是否还有更多数据 ================================================================================ 七十九、二级分类自适应宽度布局（重要） ================================================================================ 1. 问题：二级分类项宽度不一致，超出屏幕 2. 解决方案：使用 flex 布局自适应宽度 ```css .sub-category-list { display: flex; flex-direction: row; flex-wrap: nowrap; width: 100%; justify-content: space-between; } .sub-category-item { display: flex; flex-direction: column; align-items: center; justify-content: center; padding: 8px 4px; background: #f5f5f5; border-radius: 8px; flex: 1; /* 自动扩展填充空间 */ min-width: 50px; /* 最小宽度保证可读性 */ } ``` 3. 布局效果 - 二级分类项均匀分布在一行内 - 根据容器宽度自适应 - 不会超出屏幕右边 ================================================================================ 八十、Product 类型与服务层返回类型一致性（重要） ================================================================================ 1. 问题：页面期望的数据类型与服务层返回类型不匹配 - 服务层 `getProductById` 返回 `Product` 类型 - 页面可能期望 `UTSJSONObject` 类型 - 导致数据无法正确映射 2. 解决方案：统一使用服务层返回的类型 ```typescript // 正确：直接使用 Product 对象 const dbProduct = await supabaseService.getProductById(productId) if (dbProduct != null) { this.product = { id: dbProduct.id, name: dbProduct.name, stock: dbProduct.stock ?? dbProduct.total_stock ?? 0, sales: dbProduct.sale_count ?? 0, // ... } } ``` 3. 类型定义需要包含所有使用到的字段 - 确保 `Product` 类型包含所有必要字段 - 如 `specification`、`usage`、`expiry_date` 等 ================================================================================ 八十一、parseProductFromRaw 辅助函数（重要） ================================================================================ 1. 使用统一的解析函数处理数据库返回数据 ```typescript function parseProductFromRaw(item: any): Product { const itemObj = JSON.parse(JSON.stringify(item)) as UTSJSONObject const getSafeString = (key: string): string => { const val = itemObj.get(key) if (val == null) return '' if (typeof val == 'string') return val if (typeof val == 'number') return val.toString() return '' } const getSafeNumber = (key: string): number => { const val = itemObj.get(key) if (val == null) return 0 if (typeof val == 'number') return val if (typeof val == 'string') return parseFloat(val) ?? 0 return 0 } return { id: getSafeString('id'), name: getSafeString('name'), // ... } as Product } ``` 2. 优点 - 统一处理类型转换 - 避免 `ClassCastException` 错误 - 提供默认值防止空指针 ================================================================================ 八十二、点击事件处理（重要） ================================================================================ 1. 问题：点击事件条件判断不完整导致无响应 - 错误示例： ```typescript goToShop() { if (this.merchant.user_id != null && this.merchant.user_id !== '') { uni.navigateTo({ url: '...' }) } // 如果条件不满足，没有任何反馈 } ``` 2. 解决方案：添加后备方案和用户反馈 ```typescript goToShop() { const merchantId = this.merchant.id ?? this.product.merchant_id ?? '' if (merchantId != '') { uni.navigateTo({ url: `/pages/shop?merchantId=${merchantId}` }) } else { uni.showToast({ title: '店铺信息加载中', icon: 'none' }) } } ``` 3. 最佳实践 - 使用 `??` 提供后备值 - 条件不满足时给用户反馈 - 添加日志便于调试 ================================================================================ 八十三、类型定义必须与实际数据类型一致（重要） ================================================================================ 1. 问题：类型定义与实际数据类型不匹配 - `ProductSku.specifications` 定义为 `string`（JSON string） - 但代码尝试传入 `UTSJSONObject` - 编译错误：`参数类型不匹配：实际类型为 'UTSJSONObject'，预期类型为 'String'` 2. 解决方案：确保类型一致 ```typescript // 错误：specifications 是 string 类型，不能传 UTSJSONObject const sku: ProductSku = { specifications: specs as UTSJSONObject // 错误 } // 正确：转换为 JSON string let specsStr = '' if (rawSpecs != null) { if (typeof rawSpecs == 'string') { specsStr = rawSpecs as string } else { specsStr = JSON.stringify(rawSpecs) } } const sku: ProductSku = { specifications: specsStr // 正确 } ``` 3. 最佳实践 - 检查类型定义，确认字段类型 - JSON 数据存储为 `string` 类型时，需要序列化 - 使用时再反序列化 ================================================================================ 八十四、数组类型字段需要正确处理（重要） ================================================================================ 1. 问题：数据库存储的 JSON 字符串不能直接赋值给数组类型 - `Product.tags` 在数据库中是 `string` 类型（JSON 字符串） - `ProductType.tags` 是 `Array` 类型 - 直接赋值导致编译错误 2. 解决方案：解析 JSON 字符串后赋值 ```typescript // 错误：string 不能直接赋值给 Array tags: dbProduct.tags ?? [] as string[] // 错误 // 正确：先初始化空数组，再解析 JSON tags: [] as string[] // 然后解析 if (dbProduct.tags != null && dbProduct.tags != '') { try { const parsedTags = JSON.parse(dbProduct.tags) if (Array.isArray(parsedTags)) { this.product.tags = (parsedTags as any[]).map((t: any): string => t as string) } } catch(e) {} } ``` 3. 常见需要解析的 JSON 字段 - `tags` - 标签数组 - `image_urls` - 图片 URL 数组 - `specifications` - 规格对象 - `attributes` - 属性对象 ================================================================================ 八十五、服务层返回类型必须显式解析（重要） ================================================================================ 1. 问题：直接使用 `as Type` 强制转换会失败 - 错误信息：`UTSJSONObject cannot be cast to Shop` - 原因：Supabase 返回的是 `UTSJSONObject`，不能直接转换为自定义类型 2. 解决方案：使用解析函数显式转换 ```typescript // 错误：直接强制转换 return (response.data as any[])[0] as Shop // 运行时错误 // 正确：使用解析函数 const shopData = (response.data as any[])[0] const shop = this.parseShopFromRaw(shopData) return shop // 解析函数示例 parseShopFromRaw(item: any): Shop { const itemObj = JSON.parse(JSON.stringify(item)) as UTSJSONObject const getSafeString = (key: string): string => { const val = itemObj.get(key) if (val == null) return '' if (typeof val == 'string') return val return '' } return { id: getSafeString('id'), shop_name: getSafeString('shop_name'), // ... } as Shop } ``` 3. 受影响的场景 - `getShopByMerchantId` - 返回 Shop 类型 - `fetchShopCoupons` - 返回优惠券数组 - `getProductSkus` - 返回 SKU 数组 - 所有从数据库获取并返回自定义类型的函数 ================================================================================ 八十六、数组遍历不要使用 map 方法（重要） ================================================================================ 1. 问题：`map` 方法中的类型转换可能失败 - 错误信息：`ProductSku cannot be cast to UTSJSONObject` - 原因：`map` 回调中的类型推断可能不正确 2. 解决方案：使用 `for` 循环替代 `map` ```typescript // 错误：使用 map this.productSkus = skus.map((skuData): ProductSkuType => { const sku = skuData as UTSJSONObject // 可能失败 return { ... } }) // 正确：使用 for 循环 this.productSkus = [] for (let i = 0; i < skus.length; i++) { const skuData = skus[i] // 直接使用 skuData 的属性 const sku: ProductSkuType = { id: skuData.id, product_id: skuData.product_id, // ... } this.productSkus.push(sku) } ``` 3. 最佳实践 - 避免在数组方法中使用类型转换 - 使用 `for` 循环手动构建数组 - 直接访问对象属性而不是强制转换 ================================================================================ 八十七、类型定义字段必须完全匹配（重要） ================================================================================ 1. 问题：构建对象时字段名或类型不匹配 - 错误信息：`No parameter with name 'xxx' found` 或 `No value passed for parameter 'xxx'` - 原因：类型定义中的字段名与代码中使用的不一致 2. 解决方案：检查类型定义，确保字段完全匹配 ```typescript // 类型定义 export type CouponTemplateType = { id: string name: string discount_type: number // 注意：是 discount_type 不是 coupon_type discount_value: number total_quantity: number // 注意：是 total_quantity 不是 total_count usage_limit: number // 必填字段 category_ids: Array product_ids: Array // ... } // 错误：字段名不匹配 const coupon: CouponTemplateType = { usage_scope: 1, // 错误：没有这个字段 total_count: 100, // 错误：应该是 total_quantity // 缺少 usage_limit } // 正确：字段完全匹配 const coupon: CouponTemplateType = { id: '...', name: '优惠券', discount_type: 1, discount_value: 10, total_quantity: 100, usage_limit: 1, category_ids: [] as string[], product_ids: [] as string[], // 所有必填字段都要提供 } ``` 3. 常见错误 - 字段名拼写错误：`total_count` vs `total_quantity` - 缺少必填字段：`usage_limit`、`discount_type` - 类型不匹配：`string` vs `number`、`Array` vs `string` 4. 最佳实践 - 在构建对象前，先查看类型定义 - 确保所有必填字段都有值 - 数组类型字段初始化为空数组：`[] as string[]` ================================================================================ 八十八、服务层返回对象直接使用属性（重要） ================================================================================ 1. 问题：尝试将服务层返回的类型对象转换为 UTSJSONObject - 错误信息：`Shop cannot be cast to UTSJSONObject` - 原因：服务层函数（如 `getShopByMerchantId`）已经返回解析后的类型对象 2. 解决方案：直接使用返回对象的属性 ```typescript // 错误：尝试转换为 UTSJSONObject const shopResponse = await supabaseService.getShopByMerchantId(merchantId) const shop = shopResponse as UTSJSONObject // 错误！ this.merchant = { shop_name: shop['shop_name'] as string } // 正确：直接使用 Shop 对象的属性 const shopResponse = await supabaseService.getShopByMerchantId(merchantId) if (shopResponse != null) { this.merchant = { id: shopResponse.id, shop_name: shopResponse.shop_name, shop_logo: shopResponse.shop_logo ?? '/static/default-shop.png', // ... } as MerchantType } ``` 3. 受影响的函数 - `getShopByMerchantId()` - 返回 `Shop` 类型 - `getProductById()` - 返回 `Product` 类型 - `getProductSkus()` - 返回 `ProductSku[]` 类型 - 所有使用 `parseXxxFromRaw()` 解析的函数 4. 最佳实践 - 检查服务层函数的返回类型 - 如果返回类型是具体类型（如 `Shop`），直接使用属性 - 如果返回类型是 `any` 或 `UTSJSONObject`，才需要手动解析 ================================================================================ 八十九、数组类型返回值必须手动解析（重要） ================================================================================ 1. 问题：直接使用 `as Type[]` 转换数组会失败 - 错误信息：`UTSJSONObject cannot be cast to Notification` 或 `ClassCastException` - 原因：Supabase 返回的是 `UTSJSONObject[]`，不能直接转换为自定义类型数组 2. 解决方案：使用 for 循环手动解析每个元素 ```typescript // 错误：直接转换数组 return response.data as Notification[] // 运行时错误 // 正确：手动解析每个元素 const rawData = response.data if (rawData == null) return [] const notifications: Notification[] = [] const rawList = rawData as any[] for (let i = 0; i < rawList.length; i++) { const item = rawList[i] const noteObj = JSON.parse(JSON.stringify(item)) as UTSJSONObject const note: Notification = { id: getSafeString('id'), title: getSafeString('title'), content: getSafeString('content'), is_read: getSafeBoolean('is_read'), // ... } notifications.push(note) } return notifications ``` 3. 受影响的函数 - `getUserNotifications()` - 返回 `Notification[]` - `getChatRooms()` - 返回 `ChatRoom[]` - 所有返回自定义类型数组的服务层函数 4. 最佳实践 - 创建 `getSafeString`、`getSafeNumber`、`getSafeBoolean` 辅助函数 - 使用 `for` 循环而不是 `map` 方法 - 确保类型定义中的所有字段都被正确赋值 ================================================================================ 九十、reverse() + map() 组合在 UTS Android 中的问题（重要） ================================================================================ 1. 问题：`array.reverse().map()` 组合可能失败 - `reverse()` 会修改原数组 - `map()` 中的类型转换可能失败 - 组合使用时可能导致数据丢失或类型错误 2. 解决方案：使用 for 循环反向遍历 ```typescript // 错误：使用 reverse() + map() messages.value = rawMsgs.reverse().map((m: ChatMessage): UiChatMessage => { return { id: m.id, content: m.content } }) // 正确：使用 for 循环反向遍历 const uiMessages: UiChatMessage[] = [] for (let i = rawMsgs.length - 1; i >= 0; i--) { const m = rawMsgs[i] const uiMsg: UiChatMessage = { id: m.id, content: m.content ?? '' } uiMessages.push(uiMsg) } messages.value = uiMessages ``` 3. 优点 - 不修改原数组 - 类型安全 - 更好的性能 ================================================================================ 九十一、实时订阅中的字符串比较（重要） ================================================================================ 1. 问题：实时订阅回调中使用 `===` 和 `!==` 比较字符串失败 - 症状：收到消息但条件判断失败，消息不显示 - 原因：`===` 和 `!==` 在 UTS Android 中可能对字符串比较失败 2. 解决方案：使用 `==` 和 `!=` 进行字符串比较 ```typescript // 错误：使用 === 和 !== if (senderId === currentUserId.value) { return // 可能失败 } if (receiverId === currentUserId.value) { if (senderId !== merchantId.value) { return // 可能失败 } } // 正确：使用 == 和 != if (senderId == currentUserId.value) { return // 正确工作 } if (receiverId == currentUserId.value) { if (senderId != merchantId.value) { return // 正确工作 } } ``` 3. 调试技巧 - 在条件判断前添加日志输出变量值 - 比较字符串时使用 `==` 和 `!=` - 确保变量不为 null 或 undefined ================================================================================ 九十二、多端实时同步消息处理（重要） ================================================================================ 1. 问题：多端同时在线时，自己发送的消息在其他端不显示 - 原因：实时订阅中跳过了自己发送的消息 - 错误逻辑：`if (senderId == currentUserId.value) return` 2. 解决方案：正确处理自己发送的消息 ```typescript // 错误：跳过自己发送的消息 if (senderId == currentUserId.value) { return // 导致其他端看不到自己发的消息 } // 正确：判断消息类型并显示 const isMyMessage = (senderId == currentUserId.value) const isForMe = (receiverId == currentUserId.value) if (isMyMessage || isForMe) { const incomingMsg: UiChatMessage = { id: msgId, type: isMyMessage ? 'sent' : 'received', // 区分发送/接收 content: newMsg.getString('content') ?? '', time: timeStr } messages.value.push(incomingMsg) } ``` 3. 避免重复消息 - 发送消息时不要使用乐观更新 - 等待实时订阅推送消息 - 检查消息 ID 是否已存在 ```typescript // 错误：乐观更新 + 实时订阅 = 重复消息 messages.value.push(newMessage) // 乐观更新 await supabaseService.sendMessage(...) // 实时订阅会再推送一条 // 正确：只依赖实时订阅 await supabaseService.sendMessage(...) // 实时订阅推送消息 // 检查重复 for (let i = 0; i < messages.value.length; i++) { if (messages.value[i].id == msgId) { return // 已存在，跳过 } } ``` 4. 最佳实践 - 统一使用实时订阅处理所有消息（包括自己发送的） - 发送消息后不进行乐观更新 - 通过消息 ID 去重 ================================================================================ 九十三、避免使用 .single() 和 forEach（重要） ================================================================================ 1. 问题：`.single()` 和 `forEach` 在 UTS Android 中可能失败 - `.single()` 可能导致类型转换错误 - `forEach` 中的类型判断可能失败 2. 解决方案：使用 `.limit(1)` 和 `for` 循环 ```typescript // 错误：使用 .single() const response = await supa .from('ml_orders') .select('*') .eq('id', orderId) .single() .execute() return response.data // 正确：使用 .limit(1) const response = await supa .from('ml_orders') .select('*') .eq('id', orderId) .limit(1) .execute() const rawList = response.data as any[] if (rawList.length == 0) return null return rawList[0] ``` 3. forEach 替换为 for 循环 ```typescript // 错误：使用 forEach notes.forEach((note: Notification) => { if (note.type === 'order') { // === 可能失败 orderMessages.push(item) } }) // 正确：使用 for 循环 for (let i = 0; i < notes.length; i++) { const note = notes[i] if (note.type == 'order') { // 使用 == orderMessages.push(item) } } ``` ================================================================================ 九十四、嵌套对象数据解析（重要） ================================================================================ 1. 问题：Supabase 返回的嵌套对象无法直接访问 - `dataObj['ml_order_items']` 可能返回 undefined - `dataObj['shipping_address']` 类型转换失败 2. 解决方案：使用 `JSON.parse(JSON.stringify())` 和 `UTSJSONObject.get()` ```typescript // 错误：直接访问属性 const dataObj = data as Record const items = dataObj['ml_order_items'] // 可能失败 orderItems.value = items as OrderItemType[] // 正确：使用 UTSJSONObject 解析 const dataObj = JSON.parse(JSON.stringify(data)) as UTSJSONObject // 解析嵌套数组 const itemsRaw = dataObj.get('ml_order_items') if (itemsRaw != null && Array.isArray(itemsRaw)) { const items = itemsRaw as any[] orderItems.value = [] for (let i = 0; i < items.length; i++) { const itemObj = JSON.parse(JSON.stringify(items[i])) as UTSJSONObject const orderItem: OrderItemType = { id: (itemObj.get('id') ?? '') as string, product_name: (itemObj.get('product_name') ?? '') as string, // ... } orderItems.value.push(orderItem) } } // 解析嵌套对象 const addressRaw = dataObj.get('shipping_address') if (addressRaw != null) { const addressObj = JSON.parse(JSON.stringify(addressRaw)) as UTSJSONObject deliveryAddress.value = { name: (addressObj.get('name') ?? '') as string, phone: (addressObj.get('phone') ?? '') as string, // ... } as AddressType } ``` 3. 最佳实践 - 所有嵌套数据都需要显式解析 - 使用 `??` 提供默认值 - 添加日志确认数据解析成功 ================================================================================ 九十五、避免使用 .single() 查询单条数据（重要） ================================================================================ 1. 问题：`.single()` 在 UTS Android 中可能导致类型转换错误 - 错误信息：`UTSArray cannot be cast to UTSJSONObject` - 原因：`.single()` 返回的数据格式与预期不符 2. 解决方案：使用 `.limit(1)` 替代 ```typescript // 错误：使用 .single() const response = await supa .from('ml_user_profiles') .select('*') .eq('user_id', userId) .single() .execute() return response.data // 正确：使用 .limit(1) const response = await supa .from('ml_user_profiles') .select('*') .eq('user_id', userId) .limit(1) .execute() const rawData = response.data if (rawData == null) return null const rawList = rawData as any[] if (rawList.length == 0) return null return rawList[0] ``` 3. 最佳实践 - 所有查询单条数据的场景都应使用 `.limit(1)` - 始终将返回数据作为数组处理 - 检查数组长度后再取第一个元素 ================================================================================ 九十六、避免使用 .map() 处理数组转换（重要） ================================================================================ 1. 问题：`.map()` 中的类型转换可能在 Android 端失败 - 错误信息：类型转换异常或数据丢失 - 原因：`.map()` 回调中的类型推断可能不正确 2. 解决方案：使用 `for` 循环替代 ```typescript // 错误：使用 .map() const products = rawData.map((item: any): Product => { const obj = item as UTSJSONObject return { id: obj.getString('id') ?? '', name: obj.getString('name') ?? '' } as Product }) // 正确：使用 for 循环 const products: Product[] = [] for (let i = 0; i < rawData.length; i++) { const item = rawData[i] const obj = JSON.parse(JSON.stringify(item)) as UTSJSONObject const product: Product = { id: obj.getString('id') ?? '', name: obj.getString('name') ?? '' } as Product products.push(product) } ``` 3. 最佳实践 - 所有数组转换都应使用 `for` 循环 - 使用 `JSON.parse(JSON.stringify())` 确保正确转换为 UTSJSONObject - 显式声明结果数组类型 ================================================================================ 九十七、scroll-view 必须正确配置（重要） ================================================================================ 1. 问题：scroll-view 在 Android 端无法滚动 - 原因1：使用了错误的属性语法 `scroll-y` 而不是 `:scroll-y="true"` - 原因2：缺少高度约束 2. 解决方案 ```html

``` ```css /* 父容器 */ .parent-container { flex: 1; height: 0px; /* 关键：配合 flex: 1 使用 */ display: flex; flex-direction: column; } /* scroll-view */ .content { flex: 1; height: 0px; /* 关键：确保有高度约束 */ } ``` 3. 最佳实践 - scroll-view 的 scroll-y 属性必须使用绑定语法 `:scroll-y="true"` - 父容器和 scroll-view 都需要设置 `flex: 1` 和 `height: 0px` - 确保 scroll-view 有明确的高度约束 ================================================================================ 九十八、Record 访问属性（重要） ================================================================================ 1. 问题：`any` 类型无法直接访问属性 - 错误信息：`找不到名称 "xxx"` - 原因：`any` 类型不支持直接属性访问 2. 解决方案：转换为 `Record` 后使用索引访问 ```typescript // 错误：直接访问 any 类型属性 const order = orders[i] as any const status = order.status // 错误！ // 正确：转换为 Record const order = orders[i] as Record const status = order['status'] as number // 正确 ``` 3. 最佳实践 - 对于需要访问属性的对象，使用 `Record` 类型 - 使用索引访问 `obj['property']` 而非点访问 `obj.property` - 访问后使用 `as Type` 进行类型转换 ================================================================================ 九十九、保留嵌套数据结构（重要） ================================================================================ 1. 问题：类型定义不包含嵌套字段导致数据丢失 - 例如：`OrderType` 不包含 `ml_order_items` 字段 - 强制转换后会丢失嵌套数据 2. 解决方案：使用 `any` 或 `Record` 保留完整数据 ```typescript // 错误：强制转换丢失嵌套数据 const order: OrderType = { id: o.getString('id') ?? '', // ... 其他字段 } as OrderType // ml_order_items 数据丢失！ // 正确：保留嵌套数据 const orderItem: Record = { id: o.getString('id') ?? '', // ... 其他字段 ml_order_items: o.get('ml_order_items') // 保留嵌套数据 } ``` 3. 最佳实践 - 如果需要访问嵌套数据，不要使用不包含这些字段的类型 - 使用 `Record` 或 `any` 保留完整数据结构 - 在访问嵌套数据时进行类型转换 ================================================================================ 一百、Supabase 查询中整数字段处理（重要） ================================================================================ 1. 问题：Supabase 查询时整数字段导致类型转换异常 - 错误信息：`java.lang.Integer cannot be cast to java.lang.String` - 原因：UTS Android 中 Supabase 查询的 `.eq()`、`.in()` 等方法对整数字段需要使用字符串形式 2. 解决方案：整数字段使用字符串形式 ```typescript // 错误：直接使用数字 .eq('target_type', 1) .eq('status', 1) .in('category_id', [1, 2, 3]) // 正确：使用字符串形式 .eq('target_type', '1') .eq('status', '1') .in('category_id', ['1', '2', '3']) ``` 3. insert 语句中同样需要使用字符串 ```typescript // 错误：直接使用数字 .insert({ target_type: 1, status: 1 }) // 正确：使用字符串形式 .insert({ target_type: '1', status: '1' }) ``` 4. 常见需要处理的整数字段 - `target_type` - 收藏类型（1:商品, 2:店铺） - `status` - 各种状态字段 - `order_status` - 订单状态 - `payment_status` - 支付状态 - `shipping_status` - 发货状态 5. 最佳实践 - 所有 Supabase 查询中的整数值都使用字符串形式 - 使用 UTSJSONObject.set() 设置整数字段时也使用字符串 - 从数据库读取的整数值需要安全转换后再使用 ================================================================================ 一百零一、数据库字段类型安全转换（重要） ================================================================================ 1. 问题：数据库返回的字段类型可能与预期不符 - 错误信息：`java.lang.Integer cannot be cast to java.lang.String` - 原因：UUID 字段可能返回为 Integer，需要安全转换 2. 解决方案：使用类型检查后转换 ```typescript // 安全获取字符串类型的 ID const targetIdRaw = itemObj.get('target_id') let targetId = '' if (targetIdRaw != null) { if (typeof targetIdRaw === 'string') { targetId = targetIdRaw as string } else if (typeof targetIdRaw === 'number') { targetId = (targetIdRaw as number).toString() } } ``` 3. 通用辅助函数 ```typescript // 安全获取字符串值 function safeGetString(obj: UTSJSONObject, key: string): string { const val = obj.get(key) if (val == null) return '' if (typeof val === 'string') return val as string if (typeof val === 'number') return (val as number).toString() return '' } // 安全获取数值 function safeGetNumber(obj: UTSJSONObject, key: string): number { const val = obj.get(key) if (val == null) return 0 if (typeof val === 'number') return val as number if (typeof val === 'string') return parseFloat(val as string) ?? 0 return 0 } ``` 4. 最佳实践 - 所有从数据库获取的字段都进行类型检查 - 不要假设字段类型，使用 typeof 检查 - 提供默认值防止空指针异常 ================================================================================ 一百零二、JSON.parse() 返回值处理（重要） ================================================================================ 1. 问题：JSON.parse() 返回 Any? 类型 - 错误信息：`参数类型不匹配：实际类型为 'Any?'，预期类型为 'Any'` - 原因：JSON.parse() 返回的是可空类型，不能直接传给需要 Any 类型的函数 2. 解决方案：检查 null 后再使用 ```typescript // 错误：直接传递 JSON.parse() 结果 const parsed = JSON.parse(specs) return formatSpecs(parsed) // 错误！parsed 是 Any? 类型 // 正确：先检查 null const parsed = JSON.parse(specs) if (parsed != null) { return formatSpecs(parsed) } return '' ``` 3. 完整示例 ```typescript const getSpecText = (specs: any): string => { if (specs == null) return '' if (typeof specs === 'string') { if (specs == '') return '' try { const parsed = JSON.parse(specs) if (parsed != null) { return formatSpecs(parsed) } return specs } catch (e) { return specs } } return formatSpecs(specs) } ``` 4. 最佳实践 - JSON.parse() 返回值必须检查 null - 使用 try-catch 包裹 JSON.parse() 防止解析异常 - 提供默认值或后备方案 ================================================================================ 一百零三、响应式对象不能直接转换为 Map/Record（重要） ================================================================================ 1. 问题：ref 对象的值不能直接转换为 Record - 错误信息：`AddressTypeReactiveObject cannot be cast to Map` - 原因：Vue 的响应式对象在 UTS Android 中是特殊的代理类型，不能直接转换 2. 错误示例 ```typescript const deliveryAddress = ref(null) const getFullAddress = (addr: any): string => { if (addr == null) return '' if (typeof addr === 'string') return addr // 错误：响应式对象不能直接转换为 Record const addrObj = addr as Record return addrObj['province'] as string // 运行时错误 } // 模板中调用 {{ getFullAddress(deliveryAddress as any) }} ``` 3. 正确解决方案：使用 JSON.parse(JSON.stringify()) 转换 ```typescript const getFullAddress = (addr: any): string => { if (addr == null) return '' if (typeof addr === 'string') return addr try { // 正确：先序列化再解析为 UTSJSONObject const addrObj = JSON.parse(JSON.stringify(addr)) as UTSJSONObject const addressField = addrObj.getString('address') if (addressField != null && addressField != '') return addressField const province = addrObj.getString('province') ?? '' const city = addrObj.getString('city') ?? '' const district = addrObj.getString('district') ?? '' const detail = addrObj.getString('detail') ?? '' return province + city + district + detail } catch (e) { console.error('[getFullAddress] 解析地址失败:', e) return '' } } ``` 4. 最佳实践 - 响应式对象传递给函数时，必须使用 JSON.parse(JSON.stringify()) 转换 - 转换后使用 UTSJSONObject 的 getString()、getNumber() 方法访问属性 - 使用 try-catch 包裹防止转换异常 - 对于简单场景，可以直接在模板中访问响应式对象的属性 ================================================================================ 一百零四、数据库关联查询可能返回 null（重要） ================================================================================ 1. 问题：Supabase 关联查询可能返回 null - 症状：`ml_order_items: null` 即使数据库有关联数据 - 原因： 1. 关联表中确实没有数据 2. 外键关系配置不正确 3. 查询语法问题 2. 检查步骤 ```typescript // 1. 检查原始数据 console.log('[loadOrderDetail] 订单商品数据:', itemsRaw) // 2. 正确处理 null 情况 if (itemsRaw != null && Array.isArray(itemsRaw)) { // 处理数据 } else { console.warn('[loadOrderDetail] 订单商品数据为空') } ``` 3. 确保 Supabase 查询正确 ```typescript // 正确的关联查询语法 const response = await supa .from('ml_orders') .select(` *, ml_order_items ( id, product_id, product_name, price, quantity, image_url, specifications ) `) .eq('id', orderId) .limit(1) .execute() ``` 4. 最佳实践 - 始终检查关联数据是否为 null - 添加日志输出原始数据便于调试 - 给用户友好的提示（如"暂无商品数据"） ================================================================================ 一百零五、as UTSJSONObject 不会添加方法（重要） ================================================================================ 1. 问题：直接使用 `as UTSJSONObject` 类型断言不会让对象获得 getString/getNumber 等方法 - 错误信息：`UTSJSONObject cannot be cast to io.dcloud.uts.Map` - 原因：类型断言只是编译时行为，不会改变运行时对象的方法 2. 错误示例 ```typescript const rawItems = orderData.items as any[] for(let i = 0; i < rawItems.length; i++) { // 错误：直接 as UTSJSONObject 不会添加方法 const item = rawItems[i] as UTSJSONObject // 运行时错误：getString is not a function const productId = item.getString('product_id') } ``` 3. 正确解决方案：使用 JSON.parse(JSON.stringify()) 进行真正的转换 ```typescript const rawItems = orderData.items as any[] for(let i = 0; i < rawItems.length; i++) { // 正确：使用 JSON.parse(JSON.stringify()) 转换 const item = JSON.parse(JSON.stringify(rawItems[i])) as UTSJSONObject // 正确工作 const productId = item.getString('product_id') } ``` 4. 常见场景 - 从 Supabase 查询返回的数组元素 - 从 API 响应获取的数据 - 从页面传递的参数对象 - 嵌套在父对象中的子对象 5. 最佳实践 - 所有需要调用 getString/getNumber/getArray 方法的地方，必须先用 JSON.parse(JSON.stringify()) 转换 - 不要依赖 `as UTSJSONObject` 类型断言来添加方法 - 对于复杂对象，统一使用转换函数处理 ================================================================================ 一百零六、函数间传递对象需要序列化（重要） ================================================================================ 1. 问题：在函数间传递对象或数组时，可能遇到类型转换错误 - 错误信息：`UTSJSONObject cannot be cast to io.dcloud.uts.Map` - 原因：Vue 响应式对象、UTSJSONObject 等特殊类型在传递过程中可能无法正确序列化 2. 错误示例 ```typescript // checkout.uvue 中构建商品数组 const items: any[] = [] for (let j = 0; j < group.items.length; j++) { const item = group.items[j] // Vue 响应式对象 items.push({ id: item.id, product_id: item.product_id, // ... }) } // 传递给服务层 await supabaseService.createOrder({ items: items // 可能包含响应式代理对象 }) // 服务层处理 const rawItems = orderData.items as any[] for(let i = 0; i < rawItems.length; i++) { const item = JSON.parse(JSON.stringify(rawItems[i])) as UTSJSONObject // 仍然可能失败，因为 rawItems[i] 可能是特殊对象 } ``` 3. 正确解决方案：在传递前完全序列化 ```typescript // 在服务层接收参数时，先将整个数组序列化 const plainItems: any[] = [] for(let k = 0; k < shopItems.length; k++) { const plainItem = JSON.parse(JSON.stringify(shopItems[k])) plainItems.push(plainItem) } // 然后传递给内部函数 const orderId = await this.createOrder({ items: plainItems // 现在是普通对象数组 }) // 在 createOrder 中处理 for(let i = 0; i < rawItems.length; i++) { const itemStr = JSON.stringify(rawItems[i]) const item = JSON.parse(itemStr) as UTSJSONObject // 现在可以正确使用 getString/getNumber } ``` 4. 最佳实践 - 在函数边界处，将复杂对象序列化为普通对象 - 使用 `JSON.parse(JSON.stringify(obj))` 确保对象是普通 JavaScript 对象 - 添加日志输出对象类型便于调试 - 对于嵌套对象，每一层都需要序列化 ================================================================================ 一百零七、CSS 属性值限制（重要） ================================================================================ 1. 问题：UTS Android 不支持某些 CSS 属性值 - `gap` 属性不支持 - `calc()` 函数不支持 - `font-weight: 800` 等数值不支持（只支持 normal/bold/400/700） - `env()` 和 `constant()` 函数不支持 2. 错误示例 ```css /* 错误：gap 不支持 */ .container { display: flex; gap: 20px; } /* 错误：calc() 不支持 */ .card { width: calc(50% - 10px); } /* 错误：font-weight 数值不支持 */ .title { font-weight: 800; } /* 错误：env()/constant() 不支持 */ .bottom-bar { padding-bottom: env(safe-area-inset-bottom); } ``` 3. 正确解决方案 ```css /* 正确：使用 margin 替代 gap */ .container { display: flex; flex-wrap: wrap; } .item { margin: 10px; } /* 正确：使用百分比和 margin 替代 calc() */ .card { width: 48%; margin: 0 1%; } /* 正确：使用 bold 或 700 */ .title { font-weight: bold; } /* 正确：使用固定像素值 */ .bottom-bar { padding-bottom: 30px; } ``` 4. font-weight 支持的值 - `normal` (等同于 400) - `bold` (等同于 700) - `400` - `700` 5. 最佳实践 - 避免使用 `gap`，改用 `margin` - 避免使用 `calc()`，改用百分比和 margin 组合 - font-weight 只使用 `normal`、`bold`、`400`、`700` - 安全区域适配使用固定像素值（如 30px） 6. 其他不支持的 CSS 属性 - `overflow-wrap` 不支持 - `cursor` 不支持 - `max-width` 不支持百分比值，只支持 `number`|`pixel` ================================================================================ 一百零八、模板中 || 运算符限制（重要） ================================================================================ 1. 问题：模板中使用 `||` 运算符可能导致编译错误 - 错误信息：`Conditional statements must use boolean types` - 原因：UTS 模板中 `||` 左边必须是 boolean 类型 2. 错误示例 ```html {{ order.shop_name || '自营店铺' }} {{ item.name || '默认名称' }} ``` 3. 正确解决方案：使用三元表达式 ```html {{ order.shop_name != null && order.shop_name != '' ? order.shop_name : '自营店铺' }} {{ item.name != null && item.name != '' ? item.name : '默认名称' }} ``` 4. 最佳实践 - 模板中避免使用 `||` 运算符处理默认值 - 使用三元表达式：`condition ? value : default` - 对于字符串，使用 `!= null && != ''` 判断 ================================================================================ 一百零九、JSON.stringify 返回 Any? 类型（重要） ================================================================================ 1. 问题：JSON.stringify() 返回 Any? 类型 - 错误信息：`参数类型不匹配：实际类型为 'Any?'，预期类型为 'Any'` - 原因：JSON.stringify() 返回可空类型，不能直接使用 2. 错误示例 ```typescript const plainItems: any[] = [] for(let k = 0; k < shopItems.length; k++) { const plainItem = JSON.parse(JSON.stringify(shopItems[k])) plainItems.push(plainItem) // 错误！plainItem 是 Any? 类型 } ``` 3. 正确解决方案：检查 null 后再使用 ```typescript const plainItems: any[] = [] for(let k = 0; k < shopItems.length; k++) { const plainItemRaw = JSON.parse(JSON.stringify(shopItems[k])) if (plainItemRaw != null) { plainItems.push(plainItemRaw as any) } } ``` 4. 最佳实践 - JSON.parse() 返回值必须检查 null - 使用 `as any` 或其他具体类型进行类型转换 ================================================================================ 一百一十、类型定义必须包含所有字段（重要） ================================================================================ 1. 问题：创建类型实例时缺少必填字段 - 错误信息：`No value passed for parameter 'xxx'` - 原因：类型定义中的字段都是必填的，必须提供所有字段值 2. 错误示例 ```typescript type OrderItem = { id: string, order_no: string, merchant_id: string, // 必填字段 shop_name: string, // 必填字段 products: OrderProduct[] } // 错误：缺少 merchant_id 和 shop_name typedOrders.push({ id: mo['id'] as string, order_no: mo['order_no'] as string, products: mo['products'] as OrderProduct[] }) ``` 3. 正确解决方案：提供所有必填字段 ```typescript typedOrders.push({ id: mo['id'] as string, order_no: mo['order_no'] as string, merchant_id: (mo['merchant_id'] ?? '') as string, shop_name: (mo['shop_name'] ?? '自营店铺') as string, products: mo['products'] as OrderProduct[] }) ``` 4. 最佳实践 - 检查类型定义，确认所有字段 - 使用 `??` 提供默认值 - 对于可能为空的字段，在类型定义中使用 `string | null` 或提供默认值 ================================================================================ 一百一十一、UTSJSONObject.get() 返回值需要类型转换（重要） ================================================================================ 1. 问题：UTSJSONObject.get() 返回 Any? 类型，不能直接传给需要具体类型的函数 - 错误信息：`UTSJSONObject cannot be cast to io.dcloud.uts.Map` - 原因：get() 返回的是 Any? 类型，需要先转换为具体类型 2. 错误示例 ```typescript const item = JSON.parse(itemStr) as UTSJSONObject // 错误：get() 返回 Any?，不能直接传给 set() itemJson.set('product_id', item.get('product_id')) itemJson.set('product_name', item.get('product_name') ?? '') ``` 3. 正确解决方案：先转换为具体类型 ```typescript const itemParsed = JSON.parse(itemStr) if (itemParsed == null) { console.error('解析失败') continue } const item = itemParsed as UTSJSONObject // 正确：先获取值，再转换类型 let pId = item.get('product_id') if (pId == null) { pId = item.get('id') } const productId = (pId ?? '') as string itemJson.set('product_id', productId) const productName = (item.get('product_name') ?? '') as string itemJson.set('product_name', productName) ``` 4. 最佳实践 - JSON.parse() 返回值先检查 null，再 as UTSJSONObject - get() 返回值使用 `??` 提供默认值，再 `as string` 或其他类型 - 对于可选字段，始终提供默认值 ================================================================================ 一百一十二、onBackPress 生命周期问题（重要） ================================================================================ 1. 问题：onBackPress 在 ``` 3. 解决方案 - 移除 onBackPress 钩子，或使用其他方式处理返回事件 - 如果需要拦截返回，考虑在页面跳转逻辑中处理 4. 最佳实践 - 避免在