React Native debug-app.apk脱离开发服务器运行异常求助

问题概述 #

作为React Native新手，测试脱离开发服务器的debug-app.apk时遇到以下问题：

• 无法将OneSignal的userId发送至自有API
• OneSignal无法捕获设备
• Axios上传文件失败

但模拟器连接Metro服务器运行时，这些问题大多不存在：模拟器首次调用OneSignal时API返回400，后续尝试返回200且OneSignal正常，Axios文件上传也正常。应用的实时聊天等其他API功能运行正常。

一、OneSignal相关问题（无法捕获设备、userId无法上传） #

核心原因推测 #

1. 初始化时机过早：APP启动初期就调用getDeviceState()，此时OneSignal还未完成设备注册，返回的data可能为空或无userId。
2. 权限配置缺失：debug-apk未正确申请推送权限，导致OneSignal无法完成设备绑定。
3. 环境配置偏差：debug包的环境变量未正确切换，导致自有API地址或鉴权逻辑异常，无法接收userId。

解决方法 #

1. 改用事件监听获取userId
   不要在初始化后立即调用getDeviceState()，而是监听OneSignal的注册完成事件，确保设备绑定成功后再上传userId：

   const initOneSignal = async () => {
       OneSignal.setAppId('<MY APPID>')
       OneSignal.setLogLevel(6, 0)
       OneSignal.setRequiresUserPrivacyConsent(false)
       
       // 监听设备注册完成事件
       OneSignal.addDeviceRegisteredListener((event) => {
           const userId = event.userId;
           // 上传userId到自有API
           setNotificationId({
               variables: {
                   input: {
                       client_id,
                       notificationId: userId,
                   },
               },
           }).catch(e => console.log('上传userId失败:', JSON.stringify(e)));
       });
       
       OneSignal.promptForPushNotificationsWithUserResponse();
       return OneSignal;
   }
   

2. 检查Android权限配置
   确保AndroidManifest.xml中包含推送相关权限：

   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
   <uses-permission android:name="android.permission.WAKE_LOCK" />
   

3. 验证环境变量与API地址
   在代码中添加日志输出process.env.NODE_ENV和API地址，确认debug包使用的是正确的生产环境API配置。

二、Axios文件上传失败问题 #

核心原因推测 #

1. FormData格式错误：真实设备中文件URI格式（如content://前缀）与模拟器不同，直接传递对象导致解析失败。
2. Content-Type头冲突：手动设置multipart/form-data会覆盖Axios自动生成的带boundary的请求头，导致服务端无法解析表单。
3. 存储权限缺失：debug-apk未申请读取存储权限，无法获取文件内容。

解决方法 #

1. 修正FormData文件处理逻辑
   适配真实设备的URI格式，调整文件对象的构造方式：

   export const upload = async ({ uploadImages }: Props) => {
       const clientToken = await token()
       const data = new FormData()
       
       // 适配Android设备的URI格式
       const file = {
           uri: uploadImages.uri.startsWith('file://') ? uploadImages.uri.replace('file://', '') : uploadImages.uri,
           type: uploadImages.type,
           name: uploadImages.name
       }
       data.append('file', file)
       
       try {
           const res = await api.post('/upload', data, {
               headers: {
                   // 移除手动设置的Content-Type，让Axios自动生成
                   authorization: `Bearer ${clientToken}`,
               },
           })
           return res.data
       } catch (e) {
           console.log('UploadErro:', JSON.stringify(e))
       }
   }
   

2. 移除手动设置的Content-Type
   Axios会自动为FormData请求添加带boundary的Content-Type，手动设置会导致解析错误。
3. 添加存储权限
   在AndroidManifest.xml中添加读取存储的权限：

   <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
   <!-- 兼容Android 13以下版本 -->
   <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
   

通用排查技巧 #

• 查看设备日志：用adb logcat命令抓取真实设备的应用日志，获取API请求、OneSignal初始化的详细错误信息。
• 对比环境差异：检查设备的网络环境、系统版本、权限状态，确认是否存在模拟器没有的限制。
• 服务端日志排查：在自有API端添加请求日志，查看接收的参数格式是否符合要求，定位400错误的具体原因。

内容的提问来源于stack exchange，提问作者Felkng