光伏功率预测系统部署环境清单与避坑指南

简介：这份PDF是国能日新光伏功率预测系统的用户使用手册V1.0.1，面向光伏电站运维人员、电力调度相关从业者及新能源功率预测初学者，用于指导该专业软件的日常操作与配置管理。手册围绕人机界面、接口与数据库三部分展开，涵盖用户管理、系统设置、状态监测、预测曲线、气象信息、统计分析与报表等功能，并详细说明预测设置、光伏限电设置、计划开机容量、电场与组件、逆变器、气象站信息等配置项，以及短期预测、超短期预测、数据补传、辐照度功率对比、理论功率与受阻电量、日报月报年报等模块。资源包共1个PDF文件，大小约15.99MB，目录结构完整，便于按章节检索查阅。已有2842人学习下载，适合需要快速熟悉系统界面、掌握参数配置与报表使用方法的读者作为案头操作参考。

1. 光伏功率预测系统部署：从一份 V1.0.1 手册倒推出来的环境清单

上周帮一个做电站运维的朋友收拾一台被前任“装了一半”的服务器，桌面上一份《光伏功率预测系统用户使用手册 V1.0.1》打印稿被翻得卷了边，可机器上的服务起不来、首页白屏、后台接口日志里全是数据库连接超时。这类光伏电场光能预报智能管理系统的部署，坑往往不在“装”，而在装之前没把环境列清：人机界面是客户端程序，接口和数据库是后台常驻服务，三者版本对不上，界面能打开也读不到数据。这份手册把操作讲得很细，但安装配置部分默认由技术人员完成，于是很多人卡在“照着界面点得动，服务却跑不通”这一步。这篇笔记按我自己的部署习惯，把国能日新光伏功率预测系统 V1.0.1 这套环境从版本选择、依赖准备、配置项填写到装坏后的排查，完整走一遍，适合第一次独立部署这套系统的运维和开发，也适合接手别人半成品环境、需要快速定位问题的人。

2. 装前定版本：V1.0.1 手册对应的运行环境怎么选

2.1 从手册结构反推三块运行组件

手册第一章写得很清楚，系统由人机界面、接口和数据库三部分组成。人机界面是客户端程序，负责用户管理、系统设置、状态监测、预测曲线、气象信息、统计分析和报表；接口和数据库是后台运行程序，负责接收、计算和存储系统运行数据，初始安装配置后自动运行。这句话决定了部署顺序：先落数据库，再起接口服务，最后配客户端访问入口。顺序反了，客户端能登录但首页六块数据（电场数据、气象数据、今日预测、短期与超短期）全是空的，排查起来会误以为是前端问题。

我一般把这三块拆成一张环境对照表，装之前先逐项打勾，缺一项就先补，不急着点安装包：

这张表不是摆设。手册里预测设置、限电设置、计划开机容量设置都有新增、修改、详情、删除操作，其他菜单只有详情，说明写操作集中在少数配置表上，读操作遍布全站。数据库权限如果给得过宽，误删主预测记录这种不可恢复操作的风险会放大；给得过窄，详情页又会报查询失败。常见做法是给接口服务一个读写账号，给报表查询单独一个只读账号，客户端不直连数据库。

2.2 版本对齐：手册 V1.0.1 与现场组件的取舍

手册历史版本记录里，V1.0.1 是 2018 年 4 月 23 日修改文档格式的版本，正文日期标注为 2017 年 8 月 22 日。这意味着手册描述的是那一代界面和配置逻辑，现场如果拿到的是更晚的安装包，菜单名可能一致但字段有增减。我的做法是以现场安装包自带的版本说明为准，手册只作为操作路径参考，不拿手册去反推安装包版本号。版本对不上时，优先保证数据库结构和接口服务是同一批交付物，客户端可以用较新的浏览器访问，但不要混用不同批次的接口和数据库。

另一个容易忽略的点是时区。限电设置的开始时间和结束时间相隔只能是 15 分钟的倍数，这个校验在界面上做，但底层存的是时间戳。数据库时区如果和电场所在时区差几个小时，界面上填对了，报表里短期预测日报的时段会整体偏移，功率误差统计也跟着失真。装之前先把操作系统时区、数据库时区、接口服务时区三处对齐，这一条比选什么版本都优先。

2.3 依赖准备清单与安装顺序

按上面的组件拆分，装前准备可以落成一份可执行的顺序清单。下面这段是我习惯用的目录和检查脚本，放在部署机上先跑一遍，确认基础条件再往下走：

#!/bin/bash # 部署前环境自检：时区、字符集、端口、磁盘 echo "== 系统时区 ==" timedatectl | grep "Time zone" echo "== 数据库字符集（以本机数据库客户端为例）==" # 连接串按现场实际替换，这里只验证能否取到字符集 mysql -h 127.0.0.1 -u readonly_probe -p -e "SHOW VARIABLES LIKE 'character_set_server';" 2>/dev/null echo "== 接口服务端口占用 ==" # 手册未给固定端口，按现场交付说明替换 PORT PORT=8080 ss -lntp | grep ":${PORT}" || echo "port ${PORT} free" echo "== 数据盘剩余空间 ==" df -h /data

这段脚本不产生任何写操作，只做读取。时区那行用来确认不是 UTC；字符集那行确认服务端不是 latin1，否则电场名称、组件型号里的中文会变成问号；端口那行确认接口服务要用的端口没被旧进程占着，接手半成品环境时这一步能省掉大量“服务起了但访问不通”的误判；磁盘那行看数据盘，预测结果和报表文件会持续增长，空间不足时接口服务不一定立刻报错，而是写库失败后静默丢数据。

依赖装完再谈安装包。数据库先建库建账号，接口服务解压后改配置文件里的数据库连接串和监听地址，客户端最后配访问入口。每一步做完都做一次最小验证：数据库能连、接口健康检查能返回、客户端能打开登录页。不要三块全装完再一起调，出了问题分不清是哪一层。

3. 配置落地：预测设置、限电设置与开机容量三张表怎么填

3.1 预测设置：主预测只留一条的约束怎么落到部署上

预测设置是整套系统里最容易被低估的一步。手册写得很明确：主预测只保留一条数据，如果添加的是主预测且之前有主预测数据，添加后之前的主预测变成非主预测；删除主预测时会提示先设置其他信息为主预测。这个约束不是界面上的花活，它对应后台预测任务的调度入口——系统靠“主预测”这条记录决定用哪套预测数据源和启动时间。

部署时我一般先确认库里预测设置表的初始状态。全新环境通常是空的，需要手工新增第一条并勾选主预测；接手环境则要先查有没有多条被标成主预测的脏数据，有的话预测任务可能重复跑或者跑错数据源。下面这条查询只读，用来核对：

-- 核对预测设置中主预测记录数量，正常应为 1 -- 表名按现场实际替换，字段名以交付库结构为准 SELECT id, farm_id, is_main, start_time, data_source FROM forecast_config WHERE is_main = 1;

如果返回 0 条，说明还没设主预测，新增一条并勾选主预测即可；返回多于 1 条，说明历史操作留下了脏数据，需要保留一条、其余改为非主预测，改之前先备份这张表。字段含义上，farm_id 对应所属电场，手册提醒新增和修改时系统默认当前预测设置的所属电场为“选择电场”的值，所以操作前先把左上角电场切对，否则会把配置写到别的电场名下，后面短期预测日报对不上电场就是从这里来的。

启动时间和数据源这两项，手册没有展开字段格式，按现场交付说明填。我的习惯是启动时间避开整点高峰，数据源先只配一路，跑通短期预测和超短期预测各一次，再决定要不要加第二路。一次配全看似省事，出问题时两路数据源互相覆盖，日志里看不出是谁写的。

3.2 光伏限电设置：15 分钟倍数校验背后的时间处理

限电设置是把调度限电计划手动录入数据库。手册里有一条硬约束：开始时间和结束时间相隔只能是 15 分钟的倍数，否则弹出提示要求重填。这条约束在界面上拦得住手工录入，但拦不住批量导入和直接写库。部署阶段如果要从旧系统迁移限电历史，最容易在这里翻车——旧数据的时间粒度可能是 10 分钟或任意分钟，直接灌进去，界面查询能出来，但受阻电量统计和理论功率对比会算错。

迁移前先做一次粒度检查，把不满足 15 分钟倍数的记录挑出来：

-- 找出限电记录中起止时间差不满足 15 分钟倍数的数据 -- 时间字段按现场实际替换，这里用 start_time / end_time 示意 SELECT id, farm_id, start_time, end_time, TIMESTAMPDIFF(MINUTE, start_time, end_time) AS diff_min FROM curtailment_plan WHERE TIMESTAMPDIFF(MINUTE, start_time, end_time) % 15 <> 0;

查出来的记录不要直接改，先和调度计划原始单据核对，确认是录入误差还是原始计划本身就不是 15 分钟粒度。属于录入误差的，按最接近的 15 分钟边界修正并留记录；属于原始计划粒度的，和现场确认后再决定是否拆分记录。限电设置支持导出，导出的是符合当前查询条件的数据，迁移前后各导一次做比对，比肉眼翻页可靠。

另外，限电设置的新增和修改同样默认所属电场为“选择电场”的值，和预测设置一个逻辑。部署时我会把这条写进操作规范：任何新增修改前先确认电场选择框，做完立刻用详情回看一条，确认 farm_id 没写错。这个动作花十秒，能省掉后面按电场出报表时对不上账的半天。

3.3 计划开机容量与电场基础信息：预测精度的地基

计划开机容量设置是用户根据电场逆变器实际运行情况填写计划开机容量，手册说得很直白：设置开机容量可更好地帮助预测服务做好电场出力预测，提高预测精度。这条配置和电场信息、组件信息、逆变器信息、气象站信息是一组，属于“详情为主、少改少动”的基础数据。部署顺序上，我一般先把电场信息、组件信息、逆变器信息、气象站信息这四类详情数据核对完，再填计划开机容量，最后才动预测设置。原因很简单：预测设置里的数据源和启动时间依赖电场标识，计划开机容量依赖逆变器实际容量，基础信息错一位，后面全歪。

这四类信息在界面上只有详情操作，说明它们多半由交付时的初始化数据带进来，现场只做核对。核对时重点看三处：电场装机容量与逆变器数量、单机容量之和对不对得上；组件型号和数量与现场台账是否一致；气象站的位置和采集要素是否覆盖辐照度、温度、湿度、气压——手册气象信息菜单下正好是光伏温度、光伏湿度、光伏气压、辐照度曲线四项，缺哪项，对应曲线就是空的。

计划开机容量本身按时间段填写，新增、修改、详情、删除、确认、导出都支持。我的做法是按月度或按检修计划分段填，不要一条记录覆盖全年。分段填的好处是检修期容量下降有据可查，短期预测日报里的理论功率和实际功率对比才有解释力。填完用导出功能导一份留档，后面功率误差统计出现异常时，先拿这份留档对时间，能快速判断是预测模型问题还是容量配置问题。

4. 避坑排查：这套系统装坏之后怎么救

4.1 首页六块数据全空，接口日志却是正常启动

现象：客户端能登录，首页电场数据、气象数据、今日预测、短期与超短期全是空块，接口服务进程在，日志没有明显报错。

原因：接口服务连的数据库和客户端读的数据库不是同一个实例，或者接口服务连上了但账号没有对应电场的读权限。手册说接口和数据库初始安装配置后自动运行，很多人装完只验证了进程在，没验证数据链路。

解决：先在接口服务器上用服务账号执行一条最小查询，确认能读到电场表和预测结果表；再在客户端侧确认访问的接口地址指向这台服务器。两边都通还空，查接口配置里的电场标识是否和数据库里的 farm_id 一致。我遇到过配置文件里电场标识带空格的情况，界面不报错，查询条件永远匹配不上。

4.2 删除主预测被拦住，提示先设置其他信息为主预测

现象：想删掉旧的主预测记录，弹窗提示请先设置其他信息为主预测，点 ok 后不知道下一步做什么。

原因：这是手册写明的约束，主预测必须保留一条。删除操作不可恢复，系统用这条约束防止把预测调度入口删空。

解决：不要想着绕过。先新增或修改另一条记录，把它设为主预测，原主预测会自动变成非主预测，然后再删。操作前把预测设置列表导出或截图留档，删完核对主预测数量仍为 1。接手环境时如果发现主预测记录指向一个已停用电场，同样按这个顺序换主，不要直接改库。

4.3 限电记录导入后报表时段整体偏移

现象：限电设置界面里时间看着对，短期预测日报和受阻电量统计的时段却整体差几个小时。

原因：数据库时区、接口服务时区、客户端展示时区不一致。15 分钟倍数校验只校验差值，不校验时区基准，所以能通过界面校验的数据，落到库里可能是另一个时区的时间戳。

解决：三处时区统一后再重新导入。已经导入的数据，先按 4.2 节的思路备份限电表，再用 SQL 按固定偏移修正，修正后抽查几条与调度原始单据比对。修正脚本不要在生产库直接跑，先在测试库验证偏移量。

4.4 气象曲线有温度没辐照度，预测精度明显下降

现象：气象信息菜单下光伏温度、光伏湿度、光伏气压都有曲线，辐照度曲线是空的，功率预测结果偏差变大。

原因：气象站信息里采集要素没配全，或者辐照度数据上传通道没通。手册把辐照度曲线单列，说明它是独立采集项，不是温度湿度的附带字段。

解决：先查气象站信息详情，确认辐照度采集项已启用；再查接口服务日志里辐照度数据的上传记录，看是没收到还是收到没入库。数据补传功能可以用来补历史缺口，但补传前先确认通道恢复，否则补传任务会反复失败。补传完成后用辐照度功率对比功能看实际功率和理论功率的贴合度，比单看曲线更直接。

4.5 报表导出成功但文件打不开

现象：短期预测月报、光伏电场累计年报点导出，浏览器提示下载完成，打开是乱码或提示文件损坏。

原因：接口服务所在磁盘空间不足，导出文件写到一半被截断；或者导出临时目录权限不对，服务账号写不进去但错误被吞掉。

解决：先看数据盘剩余空间，再看接口服务运行账号对导出临时目录的写权限。手册里报表种类多，短期预测日报月报年报、超短期预测日报月报年报、电场累计日报月报年报，导出频率高的时候临时文件堆积很快，建议给导出目录配定期清理，别等磁盘满了再救。

5. 装完怎么验证：用一次完整预测链路收尾

装完不验证，等于没装。我的验证习惯是走一条完整链路，而不是逐个菜单点一遍。具体做法：先在预测设置里确认主预测只有一条且电场正确，再在限电设置里新增一条 15 分钟倍数的测试限电记录，接着在计划开机容量里填一段测试时段的容量，然后触发一次短期预测和一次超短期预测，最后到数据报表里看短期预测日报和超短期预测日报是否按时段出数，再到统计分析里看功率误差统计和上传率统计有没有异常值。这条链路走通，说明数据库、接口、客户端三层是通的，配置项也落到了该落的位置。

验证时我一般盯三个数：主预测记录数、限电记录的时间差是否都是 15 的倍数、报表时段与电场时区是否一致。前两个用前面给的 SQL 就能查，第三个靠比对报表首行时间和调度单据。三个数都对，再去看首页六块数据是否齐全，顺序反过来容易被首页的展示效果带偏。

这套系统装坏之后的后悔药不多，删除操作不可恢复，主预测删空要重新设主，限电历史改错要拿原始单据对。从那以后我每次部署完都强制走一遍上面这条链路，哪怕现场催得再急，也先把主预测记录数和限电时间粒度这两个数确认了再交付。希望帮到你。

本文还有配套的精品资源，点击获取