Troubleshooting

排雷

简体中文 | English

这里的坑多半不声不响：操作看似做了其实没做，列明明在却读不到，表根本没建起来。下面每条都按“现象、原因、怎么办”来写，遇上问题按图索骥即可。

“我加了一列，什么都没变”

建表用的是 CREATE TABLE IF NOT EXISTS，注册从不改动已经存在的表。插件把新列记进了自己的描述，数据库里并没有多出来，全程没有一句提醒。

随后你会看到：提到新列的操作用不了，读这张表也可能报错，因为结果里压根没有这一列。

亡羊补牢，自己迁移数据库即可：

ALTER TABLE users ADD COLUMN joined DATE NULL;

开发库图省事，直接删表让插件重建就行。线上库还是交给原有的迁移工具，这个插件不干这件事。见 表。

“Table 'users' is already registered.”

注册是记在连接上的，而 create a connection 每执行一次都新建一条连接。所以会被拒的，是"注册时撞上一条还被别的东西持有着的连接"：第二个脚本往第一个脚本建好的那条连接上重名注册，或者 reload 之后没重新连接就注册。把连接和注册写在同一个 on load 里的脚本永远不会撞上，因为 reload 替换的是连接：

on load:
    create a connection to database "MySQL" with properties:
        url: "jdbc:mysql://localhost:3306/mydb"
        username: "root"
        password: "123456"
    register a database table "users":
        id: bigint, primary key, auto increment, not null
        name: string(64), not null

见 表。

“Table 'users' not found.”

这张表在这个连接上从未注册过。常见三种情形：负责连接与建表的脚本没跑；它更早就失败了，这时去看那一刻的 last database error；或者之后连接被顶替过，而新连接里空空如也。

“No database connected.”

当前没有连接生效：可能还没连，可能连失败了，也可能被断开了。连接一旦失败，旧连接已经关掉，所以一次写错的账号密码，就能让服上所有脚本一起陷入这个状态。见 连接。

如果具名连接已经存在、却没有一条是默认，这句会换成另一种说法，并列出名字。这时该做的是 use connection "logs" 或 make connection "logs" the default，而不是再建一条连接。

行明明在，某列却是未设置

NULL 列不会写下自己的键，因为 Skript 会删掉值为 null 的列表变量键。所以 {_user::age} is not set 的意思是“NULL 或没有这一行”，而不是“等于 0”。要分清楚，就找一个不可能为 NULL 的列来问：

if {_user::id} is not set:
    send "没有这一行。"
else if {_user::age} is not set:
    send "行在，年龄是 NULL。"

见 类型。

select many 之后 {_users::name} 是空的

select many 的键先有行号，从 1 起：{_users::1::name}。只匹配到一行，行号也还是 1。这种结果没有现成的计数表达式，行数要从行号本身取，或者自己记一个计数器。见 读取行。

一次删除或更新动了整张表

delete entities 和 update entities 允许不写 where，此时会作用于实现允许的所有行，漏写也不算错。补上条件，或者改用 by id 的写法。见 更新与删除。

“Data type 'nbtcompound' cannot be used: SkBee is not installed, and it is what provides NBT compounds.”

这个列类型依赖 SkBee，因此建表时就被拒，不会拖到第一行数据才失败。装上 SkBee，或者换个类型。再者，没有 SkBee 时脚本本来也构造不出 NBT 数据，所以这条只在“这个列本当派上用场”的服务器上出现。见 类型。

“Auto-increment column 'id' must also be a primary key.”

auto increment 需要同一列上带 primary key，因为那个值要用来认行：

    id: bigint, primary key, auto increment, not null

插入之后不知道 id 是多少

插件不会把生成的 id 交回脚本。要么自己写这个值并用 upsert，要么事后按别的列把那一行找回来。见 菜谱。

date 列的时间没了

date 列是 SQL DATE，不存时分秒。要精确时刻，请用 bigint（epoch 毫秒）或 timespan。顺带一提，time 列存的是 Minecraft 一天中的时刻，同样不是墙上时间。见 类型。

分页会漏行或重复

一页是主键顺序上的偏移，不是快照。脚本翻页期间插入或删除一行，它后面的所有行都会挪位，页边界上的那一行会被读到两次、或干脆跳过。表在被写入时，请用主键游标（id > {_last}）遍历，而不是 select page。

分页按已注册的主键排序，没有主键的表会被拒；页码从 1 起。页内的键又从 1 起（{_page::1::name}），很容易误当成整张表的第一行。见 读取行。

Skript 提示 “Empty configuration section!”

只要 section 的冒号下面没有缩进内容，Skript 就会警告一次，跟这个 section 属于哪个插件无关。这句话是 Skript 自己的解析器打的，而它背后的开关是 Skript 内部的，配置文件与脚本都够不着，关不掉。

用变量给值的写法没有正文可写，按 id 工作的写法也一样，所以这些写法都不带冒号。不带冒号的一行是 effect，不是 section，Skript 也就没什么可警告的了：

insert one {_user::*} into table "archived_users"
delete one entity from table "users" by id {_id} and wait
select entity from table "users" by id {_id} and store the result in {_user::*}

冒号是留给有东西可缩进的语句的。读取只想取一行时，一个匹配所有行的条件就能办到：

select one entity from table "users" and store the result in {_user::*}:
    where all:
        id >= 1

带 where 块、values 块或任何其它正文的 section，都保持原样。在这些一行写法出现之前写好的脚本依然能跑，也依然会挨这条警告；去掉冒号，就安静了。

表名在一台服务器能用，另一台不行

Linux 上的 MySQL 表名区分大小写，差之毫厘，谬以千里。register a database table "..." 里的名字按原样使用，之后每个 table "..." 也一样。保持同一种拼写。