Unity H5捕鱼游戏系统搭建实录：C#后端+前端完整部署
声明：本文仅供技术学习参考，不构成任何投资建议或运营指导；任何实际部署必须遵守当地法律法规，禁止用于任何违法违规用途。
上周接了个活，客户要部署一套H5捕鱼游戏系统，拿到源码包一看，典型的Unity导出项目加C#后端的架构。整个部署过程踩了几个坑，这里整理成笔记分享给需要的朋友。
源码包里主要是三类文件：.c的C语言底层模块、.cs的C#逻辑脚本、还有一堆.meta配置文件。从目录结构判断，前端是Unity WebGL导出的，后端用的应该是ASP.NET Core那套。
服务端环境配置要点
先说后端部署。我用的CentOS 7.6服务器，需要提前装好.NET运行时。这套系统依赖.NET 6.0以上版本，用yum直接装微软官方源就行。
数据库迁移处理
数据库用的MySQL 5.7，源码包里附带了.sql初始化脚本。导入时注意字符集要设成utf8mb4，不然后面多语言内容会乱码。我当时图省事用了utf8，结果后台看到的繁体中文全是问号。
配置文件在appsettings.json里，主要改三个地方：数据库连接串、Redis缓存地址、还有文件上传路径。Redis这块建议单独部署，别跟数据库混在一个实例上，高并发时会互相抢资源。
API接口调试
后端启动后用Postman测了下接口，登录、房间列表、积分查询这些基础功能都正常。有个细节要注意，JWT Token的过期时间默认是30分钟，生产环境建议改成2小时，不然玩家频繁掉线体验很差。
Unity前端资源处理
前端部分比较折腾。Unity导出的WebGL项目有个Build文件夹，里面是编译好的wasm和数据文件。直接丢到Nginx下不行，需要配置正确的MIME类型。
关键配置：Nginx要给.wasm文件加上application/wasm类型，.data文件用application/octet-stream，否则浏览器加载会报错
我测试时发现首屏加载特别慢，打开开发者工具一看，Build.data文件有80多MB。后来用Unity的压缩选项重新打包，开启Brotli压缩后体积降到30MB，加载速度快了一倍多。
多语言适配实测
这套系统支持中英日三种语言，切换逻辑在前端Resources目录下的Localization.json里。改语言包时要注意，Unity的TextMesh组件不支持动态字体，中文和日文要用不同的字体文件，不然会显示方块。
后台管理功能测试
管理后台是独立的Web项目，用Vue写的。默认账号admin/123456，登录后能看到玩家管理、房间配置、数据统计这些模块。
实测了几个常用功能：
- 玩家账号可以批量导入，支持Excel格式
- 房间配置能设置最小进入门槛、抽水比例这些参数
- 数据报表有实时在线、收入统计、留存分析，基本够用
- 日志系统记录了所有关键操作，方便后期排查问题
支付对接注意事项
支付模块预留了微信、支付宝的接口，但需要自己申请商户号。对接时建议先用沙箱环境测试，特别是回调地址配置，我第一次部署时把回调URL写错了，导致支付成功后积分没到账。
适合哪些开发者
这套系统比较适合有Unity基础的团队。如果你之前没接触过Unity，光是搞懂.meta文件的依赖关系就要花不少时间。C#后端部分倒是挺标准的，懂ASP.NET的都能看懂。
二次开发空间还不错。我帮客户加了个每日签到功能，在Controllers目录下新建个SignInController，前端加个UI界面就搞定了。代码结构算清晰，MVC分层做得挺规范。
常见问题
问：部署后前端白屏怎么办？
答：先看浏览器控制台报错。90%是Nginx的MIME类型没配对，或者Build文件夹路径不对。检查nginx.conf里的location配置，确保指向正确的Build目录。
问：玩家数据能不能迁移到其他数据库？
答：可以，但要改Entity Framework的Provider。源码默认用MySQL，如果要换SQL Server，需要修改Startup.cs里的数据库上下文配置，然后重新生成迁移文件。
问：多服务器部署怎么处理Session同步？
答：系统已经用了Redis做分布式缓存，Session数据存在Redis里。部署多台应用服务器时，只要指向同一个Redis实例就能自动同步，不需要额外配置。
问：Unity前端能不能改成原生APP？
答：理论上可以，但工作量不小。需要重新用Unity导出Android和iOS包，而且要处理原生API调用。如果只是想套个壳，用WebView加载H5版本更省事。
整体部署下来大概花了两天，主要时间耗在Unity资源优化和服务器调优上。如果你手上也有类似项目，建议先在本地把环境跑通，再往服务器上迁移，能少踩很多坑。
免责声明：本文仅供技术学习交流使用，请遵守法律法规，禁止任何违法违规用途。
声明：本文仅供技术学习参考，不构成任何投资建议或运营指导；任何实际部署必须遵守当地法律法规，禁止用于任何违法违规用途。
-
Alipay QR Code Scan
-
WeChat Scan Pay
