1. 常见问题

1.1. 支付问题

• Q：调用客户端下单接口，无法唤起支付界面。

• A：监听fail回调方法，打印返回日志查看错误code，对照下表匹配错误原因。

• 错误码：

  错误码	错误信息
  1001	支付取消
  1002	支付失败
  1005	内部错误
  710016	参数错误
  710001	未登录、登录过期
  18001006	未勾选需要开通的支付档位
  18001040	请在开放平台应用设置里面，勾选接入游戏：实名认证（国家防沉迷）并绑定渠道
  18001042	通用错误码，请在回调中查看具体错误信息
  XXXXX	其他错误情况

---

• Q：美团提供的支付档位，如果不能满足游戏中的支付场景，如何添加?
• A：对接群里直接联系美团人员（汪渝灏）添加。

---

• Q：游戏支付过程中提示「支付失败」，底部提示「签名不对，请检查签名是否与开放平台上填写一致」
• A：使用正式的美团 App，（可以在应用市场下载或者在群里反馈）

---

• Q：游戏需要自己管控未成年人支付及时长吗？
• A：不需要，美团游戏平台已经支持未成年人防沉迷管控。在中宣部网络游戏防沉迷实名认证系统与美团绑定渠道关系，然后在美团游戏开发者平台创建应用的时候填写正确的备案号即可。

---

• Q：支付成功后，服务端没有收到支付回调通知。
• A：1.检查提供给美团的回调地址，是否能被访问。2.检查回调接口method是否匹配等，回调参数详见「支付成功通知」tab页。

---

• ####Q：支付成功后，没有回到游戏，退出了容器。
• A：支付api，参数needRefresh设置，0：需退出当前游戏页面，重新打开；1：支付完成后无需退出当前游戏页面。

1.2. 实名认证问题

• Q：进入游戏之后，游戏正常加载，但弹窗提示"中宣部接口内容返回错误"或者"实名认证失败，请稍后重试"，如下图：
• A：在中宣部网络游戏防沉迷实名认证系统与美团绑定渠道关系，然后在美团游戏开发者平台创建应用的时候填写正确的备案号，备案号更新时记得要在美团游戏开发者平台中同步更新，具体操作流程详见「实名认证指南」tab页。

1.3. 登录问题

• Q：游戏界面正常加载，进入游戏后显示登陆失败或者检查网络。

• A：检查实名认证是否关联或者查看 debug 游戏包是否过期（发布开始，一周后过期）

• Q：游戏使用微信登陆，提示「错误，请重新操作」，底部提示「微信：签名不对，请检查签名是否与开放平台上填写一致」。

• A：微信登陆是要使用美团线上包，游戏调试使用的美团 App 不支持「微信登陆」功能

1.4. 容器日志

• Q：容器如何查看游戏运行日志？
• A：确认游戏二维码链接中有 debug=1 参数（比如:imeituan://www.meituan.com/mgc?mgc_id=xxx&debug=1，mgc debug 生成的测试二维码参数已经默认拼接），进入游戏后点击右上角胶囊按钮「三个点」，底部会出现面板，点击「开发者面板」，显示开发者面板信息后点击「查看日志」，日志面板就会展现，面板提供搜索和过滤功能。示意图如下：

1.5. Android容器游戏包拉取

• Q：Android容器游戏包拉取失败错误码含义？

• A：Android容器拉包失败错误对应表如下。

  错误码	说明	常见原因
  2	游戏包拉取出错	远端游戏包不存在 或 网络异常
  3	游戏包拉取数据为空	已拉取的游戏包数据有误
  4	游戏包拉取路径不存在	已拉取的游戏包本地不存在
  5	游戏包加载出错	远端游戏包不存在 或 网络异常
  6	游戏包加载数据为空	已加载的游戏包数据有误
  7	游戏包加载路径不存在	已加载的游戏包本地不存在
  8	游戏包预览版本为空	游戏预览包版本号获取失败
  9	游戏包预览版本获取失败	游戏预览包获取失败
  10	游戏包的game.json文件不存在	游戏包中game.json缺失
  11	游戏包的game.json文件为空	游戏包中game.json内容为空
  12	游戏包的game.json解析为空	游戏包中game.json数据有误
  13	游戏包的game.json屏幕设备朝向为空	游戏包中game.json中缺失屏幕朝向参数
  14	游戏包的game.json解析失败	游戏包中game.json解析失败
  15	启动引擎出错	游戏容器引擎初始化失败
  16	游戏包屏幕朝向不合法	游戏包屏幕朝向参数有误
  17	游戏运行失败	游戏运行时出现异常
  18	基础库加载失败	游戏容器基础库加载失败
  19	引擎插件加载失败	使用了未发布的插件，确认一下 game.json 的配置以及插件使用方式
  20	子包文件加载失败	游戏子包文件获取失败
  21	子包文件不存在	游戏子包文件本地持久化失败
  122	web内核基础库加载失败	web内核基础库加载失败
  123	web内核基础库加载失败	web内核基础库内容不合法
  124	web内核基础库本地路径不存在	web内核基础库本地不存在
  125	web内核游戏包版本为空	web内核游戏包版本有误
  126	web内核游戏包入口index.html本地路径为空	web内核游戏包主文档生成失败

---

1.6. 分包问题

• Q：分包最低支持版本
• A：Android 最低支持版本是 11.20.200，iOS 最低支持版本是 11.18.200

---

• Q：容器日志显示分包已经加载成功，但找不到对应文件（can not find module 'xxxx.js'）
• A：require 对应脚本时增加当前目录，例如require("test") 修改为 require("./test")

---

• Q：如何设置分包
• A：在game.json指定分包配置。root可以是目录也可以是单文件。打包上传时，会根据此配置，分别上传主包和各个子包。 game.json 示例如下:

{
  "subpackages": [
    {
      "name": "stage1",
      "root": "stage/stage1/" // 目录
    }, {
      "name": "stage2",
      "root": "stage2.js" // 单文件
    }
  ]
}

文件类型	说明	常见原因
单文件	分包中仅包含这一个文件，作为分包的入口脚本
目录	分包中会包含整个目录的内容。目录内必须包含game.js，作为分包的入口脚本

---

• Q：分包体积是否有限制
• A：主包不超过 4M，单个分包不限制大小，游戏整体包不能超过40M

---

• Q：主包大小未超过 4M，但发布时仍失败提示：「主包大小超过 4MB」
• A：
  1. 确认分包设置无误。除了分包内容，其他所有文件都会被打入主包
  2. 确认 mgc.config.js 配置的 isToES5 参数是否为 true，改为 false 后重试打包发布（需回归游戏逻辑正常）

---

1.7. oom 导致 debug 包发布失败

• Q：mgc debug 发布测试包过程中，JavaScript heap out of memory
• A：更新 node 版本(查看版本命令：node --version)，至少 v14.13.0 及其以上版本