运行JavaFX应用时触发XMLStreamException解析错误，寻求帮助

这个错误javax.xml.stream.XMLStreamException: ParseError at [row,col]:[2,6]Message: The processing instruction target matching "[xX][mM][lL]" is not allowed是XML解析器遇到的典型问题，根源在于XML声明的位置不符合规范。

错误原因 #

XML规范要求<?xml version="1.0" encoding="UTF-8"?>必须是XML文档的第一行内容，而且它的前面不能有任何空白字符（包括空格、换行、制表符），也不能有隐藏的字节标记（比如UTF-8的BOM）。如果解析器在第一行之外的地方看到了类似<?xml的处理指令，或者XML声明前面有多余内容，就会抛出这个错误。

具体解决步骤 #

针对你的情况，你可以按以下步骤排查：

• 清理FXML文件开头的所有内容：打开你的FXML文件，将光标移到最开始，删除任何前置的空格、换行或不可见字符，确保<?xml是文件的第一个字符。
• 用无BOM的UTF-8格式保存文件：很多编辑器（比如Notepad++、IntelliJ IDEA）默认保存UTF-8文件时会添加BOM（字节顺序标记），这会被解析器当成无效内容。你需要在编辑器中选择“UTF-8 无BOM”格式重新保存文件。
• 检查是否有重复的XML声明：确认你的FXML文件中只有一个XML声明，并且它位于文件最顶部。

修正后的FXML代码示例 #

这里是调整后的你的FXML代码，确保开头符合规范：

<?xml version="1.0" encoding="UTF-8"?>
<?import com.jfoenix.controls.JFXButton?>
<?import com.jfoenix.controls.JFXComboBox?>
<?import com.jfoenix.controls.JFXTextField?>
<?import java.net.URL?>
<?import javafx.scene.control.Label?>
<?import javafx.scene.effect.Reflection?>
<?import javafx.scene.layout.AnchorPane?>

<AnchorPane prefHeight="400.0" prefWidth="400.0" xmlns="http://javafx.com/javafx/8.0.121" xmlns:fx="http://javafx.com/fxml/1" fx:controller="sample.EndOfDayController">
    <children>
        <AnchorPane fx:id="eodAnchor" layoutX="14.0" layoutY="20.0" prefHeight="400.0" prefWidth="410.0" style="-fx-background-color: white;" AnchorPane.bottomAnchor="0.0" AnchorPane.leftAnchor="0.0" AnchorPane.rightAnchor="-10.0" AnchorPane.topAnchor="0.0">
            <children>
                <JFXTextField labelFloat="true" layoutX="196.0" layoutY="73.0" prefHeight="17.0" prefWidth="186.0" promptText="Date" />
                <Label layoutX="99.0" layoutY="83.0" text="End Of Day" />
                <JFXTextField labelFloat="true" layoutX="196.0" layoutY="208.0" prefHeight="42.0" prefWidth="186.0" promptText="items" unFocusColor="#4d4d4d" />
                <Label layoutX="97.0" layoutY="110.0" prefHeight="42.0" prefWidth="96.0" text="Eod Status" />
                <Label layoutX="97.0" layoutY="172.0" prefHeight="17.0" prefWidth="88.0" text="Next Pos Date" />
                <JFXComboBox labelFloat="true" layoutX="196.0" layoutY="147.0" prefHeight="42.0" prefWidth="186.0" unFocusColor="#f50a0a">
                    <effect>
                        <Reflection/>
                    </effect>
                </JFXComboBox>
                <Label layoutX="97.0" layoutY="234.0" prefHeight="17.0" prefWidth="88.0" text="Total Items Sold" />
                <JFXButton fx:id="btnOkEOD" buttonType="RAISED" layoutX="83.0" layoutY="272.0" mnemonicParsing="false" prefHeight="66.0" prefWidth="262.0" ripplerFill="#3145f5" text="Ok">
                    <stylesheets>
                        <URL value="@main.css" />
                    </stylesheets>
                </JFXButton>
                <JFXTextField labelFloat="true" layoutX="196.0" layoutY="119.0" prefHeight="25.0" prefWidth="174.0" promptText="Status" />
            </children>
        </AnchorPane>
    </children>
</AnchorPane>

额外提示 #

如果你使用的是IDEA或Eclipse这类IDE，保存文件时可以检查编码设置：

• 在IDEA中：File > Settings > Editor > File Encodings，确保UTF-8被选中，并且勾选Remove BOM选项。
• 在Eclipse中：Window > Preferences > General > Workspace，设置Text file encoding为UTF-8，保存时会自动处理BOM问题。

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